Note: The Apple Remote Access API provides an application programming interface to the Remote Access Manager. It supports calls to load and unload the Remote Access Manager (RAM), create and terminate connections, retrieve the current RAM status, and to determine if a specified network address is local or remote. Optionally, the Apple Remote Access API can display a user interface showing the process of a connection. The parameters for the connect call can be a connection document, created with the Remote Access application. The parameters of the connection, however, may not be specified out right when connecting to ARA 2.0. These specifications also include how to tell if Apple Remote Access is installed, and how to deal with the serial port when Apple Remote Access is in answer mode.
Although every attempt has been made to verify the accuracy of the information presented, this document may contain errors and is subject to change. ARA 2.0 features are not guaranteed.
Gestalts
When fully installed, Remote Access defines several new gestalt selectors. Below are the new defines and explanation of their use.
To see if serial port arbitration is installed, call _Gestalt using these defines.
#define gestaltArbitorAttr 'arb '
#define gestaltSerialArbitrationExists 0
For example:
OSErr io;
// check to see if serial port arbitrating is installed…
More information on serial port arbitration is discussed in a section below.
To see if Remote Access Connection Interface is available use these defines:
#define gestaltRemoteAccessAttr 'strm'
#define gestaltRemoteAccessExists 0
To check if Remote Access support is available in the Alias Manager use these defines:
#define gestaltAliasMgrAttr 'alis' // as defined in GestaltEqu.h
#define gestaltAliasMgrSupportsRemoteAppletalk 1
To use ARA 2.0 features, call _Gestalt using these defines.
#define gestaltRemoteAccessCallOnly 1 // checks for ARA client
#define gestaltRemoteAccessMPServer 2 // checks for ARA multi-port server
#define gestaltRemoteAccessVers2 3 // checks for ARA 2.0 features
Serial Port Arbitration
When installed Remote Access provides serial port arbitration throught the Serial Port Arbitrator tool. All serial drivers registered with the Communications Resource Manager are arbitrated by the Serial Port Arbitrator.
To check to see if the Serial Port Arbitrator is installed, check the gestaltSerialArbitrationExists flag of the gestaltArbitorAttr Gestalt selector (see “Gestalts” section for these defines and an example of this call).
If serial port arbitration is present, call OpenDriver when you want to use a serial port. If the driver requested is not open, OpenDriver will return a result of noErr and the reference number of the driver. If the driver requested is open (in use), OpenDriver will return the error portInUse. When you are finished using the driver, call CloseDriver. OpenDriver and CloseDriver calls should always be balanced, although the Serial Port Arbitrator will protect against multiple open/close calls.
If serial port arbitration is not present, do not use OpenDriver to determine if the driver is open. It will return you a result of noErr and the reference number, allowing you access to a driver that another application is using. To determine if the serial driver requested is open by another application, you must walk the DCE (Device Control Entry) unit table (see Device Driver chapter of Inside Macintosh vol II).
It is important to use the new method if serial port arbitration is available. Remote Access, when set up for answering calls, is passively using a particular serial driver. If you use the new method, the Serial Port Arbitrator will give up the passive claim and allow your OpenDriver call to return noErr. Later, when you call CloseDriver, Remote Access will again passively claim the port and setup the modem for answering.
Below is a code example in C illustrating how to use serial port drivers under the new and old methods:
The TRemoteAccessParamBlock is a union of all of the available Apple Remote Access API commands. The TRemoteAccessParmHeader is a struct which consists of a DControlParamHeader followed by a DExtendedParam which is followed by a DRemoteAccessParmHeader. The extendedCode is used to specify the Apple Remote Access API command wanted. The resultStrPtr field returns a Pascal string to indicate what error occurred. If you are not interested in the string, set this field to nil. If you do pass a pointer however, it must point to a buffer of at least 256 bytes in length. If the result of the call happens to be noErr, then the length byte of the string will be zero. Since this version of Remote Access only deals with the user port, the parameter portGlobalsPtr should always be set to zero. The csCode field should normally set to RAM_EXTENDED_CALL and the extendedType is set to REMOTEACCESSNAME. These constants are defined in RemoteAccessInterface.h.
#define DControlParamHeader \
QElem *qLink; // next queue entry \
short qType; // queue type \
short ioTrap; // routine trap \
Ptr ioCmdAddr; // routine address \
ProcPtr ioCompletion; // completion routine \
OSErr ioResult; // result code \
long userData; // for use by the user \
short unused; // unused field \
short ioRefNum; // driver reference number \
short csCode; // normally set to RAM_EXTENDED_CALL
// for Apple Remote Access API calls
#define DExtendedParam \
DControlParamHeader \
Ptr hReserved1; \
Ptr hReserved2; \
Ptr resultStrPtr; \ // set to zero if result string is unwanted
Ptr extendedType; // pointer to identifier string, normally set to // REMOTEACCESSNAME for Apple Remote Access API calls
#define DRemoteAccessParmHeader \
DExtendedParam \
short extendedCode; // for use by extended call proc \
Ptr portGlobalsPtr; // pointer to globals for this port (0=userport) \
The load command is used to ensure that the Remote Access Manager is loaded into memory and must be used before making a Connect call . It uses the standard TRemoteAccessParmBlock as the parameter block. The example code below shows how it works. To use the MungePW command, it is not necessary to use the load command first.
The unload command is used to release the Remote Access Manager and free its memory. It uses the standard TRemoteAccessParmBlock as the parameter block and can be issued immediately after making a Connect call. This allows the Remote Access Manager to be unloaded as soon as an active connection is terminated with a disconnect, if no other clients have loaded Remote Access. Below is an example unload call.
#include “RemoteAccessInterface.h”
void UnloadRemoteAccess()
{
TRemoteAccessParmBlock unloadPB;
// unload the code (will not actually go away till this connection is done)
This call is used to initiate an outgoing connection. When you are connected in this mode you will still retain access to your current network. Network numbers are re-mapped in a limited way in order to solve problems of network number conflicts between the two machines being directly connected, thus ensuring they will always be accessible to each other. Unfortunately, it is not possible to solve all of the other possible conflicts due to the limited number of network numbers available. In order to provide a method of ensuring access to all networks on the destination network a guaranteed access method is available. When connected in this mode, you will lose access to all services beyond those on the same single network number that the calling machine belongs to. In order to notify clients of the AppleTalk stack that a network will no longer be reachable we have created a new AppleTalk Transition Queue event. (See Network Transition Events later in this document.) When connecting the client passes in a TRAConnectInfoTemplate, or the FSSpec of a document which contains the connect parameters. The connect parameter block contains the optionFlags field which specifies the connect options. The flags are shown below:
// connect option flags
#define kNSCanInteract 0x00000001 // User interaction (password prompt) is OK
#define kNSShowStatus 0x00000002 // show the status of the connect or disconnect call
#define kNSConnectDocument 0x00000004 // connect using the specified document using FSSpec
#define kNSPassWordSet 0x00000010 // use the specified password field when connecting // by document
// 2.0 and above…
#define kNS2SavvyFlags 0x40000000 // Set to use the next 2 flags below for only ARA // 2.0 aware applications.
#define kNSAR2Connection 0x00000020 // connecting to a 2.0 server.
#define kNSNotifyWhileConnected 0x00000040 // display cute notification icon while connected.
The kNSCanInteract flag allows interaction with the user to get the password if necessary or prompt the user to change their password if the server requires it. The kNSShowStatus flag enables the connection status display. The display is modal dialog which updates with new messages as the connection progresses. When the kNSConnectDocument flag is set, the Apple Remote Access API will use the specified ARA 2.0 document for the connect parameters (i.e. user name, password) of the TRAConnectInfoTemplate. The document is specified by the FSSpec record which contains vRefNum (volume reference number), parID (directory ID), and name (pointer to Pascal style string containing the document name). No other parameters need to be supplied. The kNSPassWordSet flag overrides the saved password when connecting by document or by PB and forces Apple Remote Access API to use the passWord field in cleartext. If the kNSPassWordSet flag is clear and the passwordSaved flag is set, then the client must supply a munged password. The kNS2SavvyFlags is set if using ARA 2.0 features. The kNSAR2Connection flag indicates the connection is to a 2.0 server. If this bit is not set, it is assumed that it is a 1.0 connection. The kNSNotifyWhileConnected flag will display a notification icon on the Apple Menu while the user is connected.
In this release, the client may not connect by parameter block (PB). Use the kNSConnectDocument flag to connect with a specified ARA 2.0 document. The fields in the connectInfo record are discussed below. They are filled by the specified ARA 2.0 document. Within this record is a version which is used by the connect template (currently set to 1). The ltType parameter specifies the type of the link tool that will be used in this connection. The ARA 2.0 connect document specifies the length and points to the address used in connecting by setting up addressInfoLength and addressInfoPtr. The ltSpecificTemplatePtr is expected to point to the template of the link tool specific parms. An example of link tool specific parms might be items such as the serial port reference (.AIn, .AOut) that is used in the Modem Link Tool. A userName is passed in that indicates the name of the user logging in. A passWord is specified if the user is not logging in as a guest. If the user wants to be a guest, the guestLogin flag is set. The connectReminderTimer is used if the caller wants to be reminded that a connection is in progress. This field is set to the number of seconds between reminders, and can be set to zero if no reminders are wanted. If a connectReminderTimer is set you must set the connectOKWaitTimer that indicates how long the reminder dialog will wait for OK to be hit before disconnecting.
struct TRAConnectInfoTemplate
{
unsigned long version; // version of this format
unsigned long ltType; // Link Tool type
long addressInfoLength; // length of the address information
Ptr addressInfoPtr; // pointer to connect address info
long ltSpecificTemplateLength; // length of the ltspecific information
Ptr ltSpecificTemplatePtr; // pointer to link tool specific params
unsigned char passWord[PASSWORDBUFSIZE]; // user password
unsigned char userName[USERNAMESIZE]; // user name
unsigned long connectReminderTimer; // value for connection reminder in seconds
unsigned long connectOKWaitTimer; // how long to wait for OK on reminder timer
Boolean guestLogin; // try to log in as a guest
Boolean passwordSaved; // set if password is saved
Boolean guaranteedAccess; // flag to guarantee access to servers internet
ShowError(connectPB.CONNECT.ioResult); // Do Error reporting and recovery
UnloadRemoteAccess(); // Unload when disconnected.
} // DoConnect
Disconnect
The disconnect command is used to terminate an existing session or cancel one that is being created. If you only want to disconnect a session that was connected with a specific parameter block you can do so by setting a pointer to the parameter block used to issue the connect in abortOnlyThisPB. If you want to disconnect a connection created by anyone, you set the abortOnlyThisPB field to zero. If you are disconnecting an outgoing call, you pass zero in portGlobalsPtr. Disconnecting ports other than the userport, is not supported in this version. You should always set disconnectin to zero. The option kNSShowStatus will cause the Apple Remote Access API to display the status dialog during the disconnect.
#define kNumWarnEntriesMax 5 // number of entries in warn array
struct TRemoteAccessDisconnectParam
{
DRemoteAccessParmHeader
unsigned long disconnectin; // Note: Set this parameter to 0
TPRemoteAccessParamBlock abortOnlyThisPB; // only abort a connection opened by this pb
unsigned long warnArr[kNumWarnEntriesMax]; // set warn times here in seconds (zero all if
// no warnings)
unsigned long optionFlags; // bit mapped connect option flags
ShowError(disconnectPB.DISCONNECT.ioResult); // Do Error reporting and recovery
}
IsRemote
The "IsRemote" command is used to determine if a network address is remote or local. If the network is remote, the call will optionally return the information necessary to make the connection to the remote network. The parameter theAddress contains the network address to be checked. The format of theAddress is the same as for the struct AddrBlock as defined in AppleTalk.h:
Bytes 3 & 2 (High Word): Network Number
Byte 1: Node Number
Byte 0 (Low Byte): Socket Number
The optionFlags parameter is used for getting, or disposing, connection information. The following flags are defined:
#define ctlir_getConnectInfo 0x01 // will get connect info if address remote
#define ctlir_disposeConnectInfo 0x02 // will dispose info in connectInfoPtr properly
If the ctlir_getConnectInfo flag is set, and the network address is remote, the information necessary to create the remote connection is returned. If the ctlir_disposeConnectInfo flag is set, the connect information structure pointed to by connectInfoPtr, is disposed of properly.
The locationIsRemoteFlag parameter is a flag that is returned true if the network address is remote. The connectInfoLength parameter indicates the length of the connect information. The connectInfoPtr is a pointer to the connection information for connecting with the remote address. These values are returned when the network address is remote, and the ctlir_getConnectInfo flag is set.
struct TRemoteAccessIsRemoteParms
{
DRemoteAccessParmHeader
long theAddress; // address that is to be checked
unsigned long optionFlags; // Set to ctlir_getConnectInfo or
// ctlir_disposeConnectInfo, if zero only checks
// theAddress
Boolean locationIsRemoteFlag; // returns true if address is remote
long connectInfoLength; // length of the following data
TPRAConnectInfoTemplate connectInfoPtr; // The connection information template pointer
The status command is used to obtain information about Remote Access. The information you can obtain is how long a connection has been active, how much time remains in the connection, the name of the user that made an answering connection, the name of the computer you are connected to on a calling connection, and the last message that was posted. The statusBits parameter is used to determine if a connection is active, starting up, in the process of tearing down, if the connection is an answering or calling connection, if the computer is enabled to receive answer calls or if a disconnect is in progress. The following flags are defined:
// bits passed back in statusBits
#define CctlConnected 0x00000001 // set when connected
#define CctlAnswerEnable 0x00000004 // set when we are set to answer calls
#define CctlServerMode 0x00000008 // set for answer mode, clear for call mode
#define CctlConnectionAborting 0x00000010 // connection is being torn down
#define CctlConnectInProg 0x00000020 // set when connection in progress or fully
// connected
#define CctlDisconnectInStarted 0x00008000 // somebody has started a disconnectIn
#define ctlAR2Connection 0x02000000 // set when this connection is to a 2.0 server
#define ctlNotifyWhileConnected 0x04000000 // set when the user wants to be reminded while // connected.
#define ctlConnectedToMPS 0x08000000 // set when client is connected to a multi-port // server
#define CctlMultiNodeReady 0x80000000 // shows if we currently have a multinode // address to enable answer mode.
The following struct is used when making a status call:
struct TRemoteAccessStatusParam
{
DRemoteAccessParmHeader
unsigned long statusBits; // bits for current status
unsigned long timeConnected; // number of seconds we have been connected
unsigned long timeLeft; // number of seconds remaining in connection
// (0xffffffff infinite)
unsigned char *userNamePtr; // returns user name, expects pointer to buffer // of USERNAMESIZE if non nil
unsigned char *connectedToNamePtr; // returns name of where we connected to, // expects pointer to buffer of USERNAMESIZE if // non nil
TPRemoteAccessParamBlock connectedByParamPtr; // a pointer to the parameter block
// "initiating" the connection if we are // connected
TPRemoteAccessParamBlock statusConnectedByParamPtr; // a pointer to the parameter block
// "initiating" the connection when status was
// posted
unsigned char *theLastStatusMsgPtr; // expects pointer to buffer of size // MAXSTATUSMSGSIZE
unsigned char *statusUserNamePtr; // pointer to buffer of size USERNAMESIZE
long statuslttype; // link tool type
long statusmsgOptionFlags; // classification of message type
long statusMsgNum; // specific message number
long statusMsgSeqNum; // pass in zero if always want status, otherwise // use last value, if status is new, new number
// is returned
unsigned long userSignature; // signature of port creator
unsigned long userRefCon; // refcon of port creator
ShowError(statusPB.STATUS.ioResult); // Do Error reporting and recovery
else
{
// now decode the flag bits into words
statusBits = statusPB.STATUS.statusBits;
if (statusBits & CctlServerMode)
printf("Answer connection\n");
if (statusBits & CctlConnected)
printf("Calling connection\n");
if (statusBits & CctlConnectionAborting)
printf("Cancel in progress\n");
if (statusBits & CctlAnswerEnable)
printf("Waiting for incoming call\n");
if (statusBits & CctlConnectInProg)
printf("Connection in progress\n");
}
} // GetStatus
GetUserPortGlobalsPtr
In order to make the RAM Status call on a machine that is setup to answer calls, you must first make the GetUserPortGlobalsPtr call to retrieve a pointer to the globals for the user port.
The Apple Remote Access (ARA) Personal software supports dial-out and answering capabilities through a single port called the “user” port (the modem or printer port on your Mac). This means that when you setup your machine to answer calls, you can answer only one call at a time on the user port. However, the underlying ARA architecture was designed so that multiple ports may be supported (in a dial-in server for example).
When you dial-out on your Mac and establish an ARA connection, ARA internally allocates the data structures for the user port - but not until a connection is actually made. This is why, for example, the Status call will return the -5833 ERR_PORTDOESNOTEXIST error on the originating machine if there is no active connection. Once a connection has been made on a machine that is the originator of the connection, the Status call should return no error, because the data structures for the port will have been created.
When you make the Status call on a machine that is setup to answer calls (the answer calls box is checked in the Remote Access Setup control panel), you will find that you always get the -5833 ERR_PORTDOESNOTEXIST error. The reason for this is that when ARA is in answer mode it needs to be able to uniquely identify each connection with a separate portGlobalsPtr, because in the future there may be support for more than one connection on a single machine. Therefore, on a machine that is setup to answer calls, you must first retrieve the portGlobalsPtr for the user port before the Status call can be made. This is accomplished with the GetUserPortGlobalsPtr call. This call makes use of the familiar TRemoteAccessParmHeader structure. The pointer to the port globals for the user port is returned in the portGlobalsPtr field upon completion of the call. Here are the data structures used by this call:
The fields in the TRemoteAccessParmHeader structure used for the GetUserPortGlobalsPtr call to the Remote Access Manager are defined as follows:
-> 12 ioCompletion long pointer to completion routine
<- 16 ioResult word result code
-> 20 userData long for use by the user
-> 26 ioRefNum word driver reference number
-> 28 csCode word call command code
-> 40 extendedType long pointer to identifier string
-> 42 extendedCode word for use by extended call procedure
<-> 44 portGlobalsPtr long pointer to globals for this port (0 = return user port globals)
Here are the detailed descriptions of the parameter block fields used by this call:
ioCompletion pointer to completion routine.
ioResult result code returned by the call.
userData user data for use by the user.
ioRefNum driver reference number.
csCode command code, normally set to RAM_EXTENDED_CALL.
extendedType should be set to REMOTEACCESSNAME.
extendedCode set to 54 to indicate the GetUserPortGlobalsPtr call.
portGlobalsPtr returns a pointer to the globals for the port. On input pass 0 to indicate you want the user port globals.
The following result codes can be returned by the GetUserPortGlobalsPtr call:
noErr 0 no error.
ERR_PORTDOESNOTEXIST -5833 port does not exist.
ERR_PORTSHUTDOWN -5832 port is shutting down.
The following is an example of how you would use the GetUserPortGlobalsPtr call prior to making a Status call.
pb.HDR.extendedType = (Ptr)REMOTEACCESSNAME; /* to Netshare */
pb.HDR.extendedCode = CmdRemoteAccess_GetUserPortGlobalsPtr; /* get user port globals */
pb.HDR.portGlobalsPtr = nil; /* 0 = return user port globals */
PBRemoteAccess( &pb, false );
if (pb.HDR.ioResult != noErr)
HandleError(pb.HDR.ioResult);
else
{
/* Issue ARA Status Call */
ResultStr[0] = 0;
pb.STATUS.resultStrPtr = (Ptr)ResultStr; /* put results here */
pb.STATUS.extendedCode = CmdRemoteAccess_Status; /* status command */
pb.STATUS.userNamePtr = UserName;
pb.STATUS.connectedToNamePtr = ConnectedTo;
pb.STATUS.theLastStatusMsgPtr = LastMessage;
pb.STATUS.statusUserNamePtr = 0;
pb.STATUS.statusMsgSeqNum = 0;
PBRemoteAccess( &pb, false );
if (pb.STATUS.ioResult != noErr)
HandleError(pb.STATUS.ioResult);
}
}
Thus, to make sure that the RAM Status call will work on machines that are setup to answer calls, you will need to first make the GetUserPortGlobalsPtr call so that the Remote Access Manager knows which port to return status information for.
MungePW
The MungePW command is used to encrypt a password to be stored in a document. Normally, when connecting by document, it is not necessary to use this command, since the password in a document is stored in encrypted format. It uses a struct TRemoteAccessPasswordMunger with the inputs username pointer and password pointer. The reserved field should always be set to zero. The munged password is return in the data buffer pointed to by passWordPtr. It is not necessary to call the Load command before using MungePW. The maximum username and password lengths are defined in the RemoteAccessInterface.h header file.
struct TRemoteAccessPasswordMunger
{
DRemoteAccessParmHeader
unsigned char *userNamePtr; // pointer to username string
The GetCodeHooks command is used to return a pointer to the remapper procedure. This routine can then be called to do special remappings for applications passing network addresses as part of their data. The call can be made with the clients network number and the node number and this routine will return the remapped equivalents.
struct TRemoteAccessGetCodeHooks
{
DRemoteAccessParmHeader
RemmaperProcPtr remapperProc; // quick vector to remapper code
The routine returned by this call is defined as follows:
pascal void DoRemapper(unsigned long whereNet, unsigned long incomingFlag, unsigned long sourceSwapFlag, unsigned short *theNet, unsigned char *theNode)
whereNet-> This value has the net where this packet just came from or is going to, it is needed to determine if any remapping should even take place.
incomingFlag-> Set to true if data is incoming, false if data is outgoing.
sourceSwapFlag-> Set to true if a source style swap is to be used. A source style swap means that we do remappings based on the address being a source address. If this flag is false, destination style swaps are done.
theNet-> Pointer to unsigned short containing the net to be remapped.
theNode-> Pointer to unsigned char containing the node to be remapped.
Network transition events are generated by Remote Access to inform interested clients that network connectivity has changed. The type of change is indicated by the newConnectivity flag. If this flag is true, new connectivity is being added (i.e. a connection to a new internet has taken place). In this case, all network addresses will be returned as reachable. If the newConnectivity flag is false, certain networks are no longer reachable. Since Remote Access is connection based and internally functions much like a router it has knowledge of where a specific network exists. Remote Access can take advantage of that knowledge during a disconnect to inform AppleTalk clients that a network is no longer reachable. This information can be used by the AppleTalk client to age out connections immediately rather than waiting a potentially long period of time before discovering that the other end is no longer reachable.
When Remote Access is disconnecting, it will generate a "Network Transition Event (theEvent=5)" through the AppleTalk transition queue. A client upon receiving such a message can ask Remote Access (through a network validate hook passed to the client) if a specific network is still reachable. If the network is still reachable, true will be returned. A client can then continue to check other networks he is interested in until he has learned the status of each of them. After a client is finished checking his networks he returns to Remote Access where the next AppleTalk transition queue client is called.
Since the "Network Transition Event" is transitional, it is important to realize that the information that the network validate hook returns is only valid if a client has just been called as a result of a transition. In other words, a client can only validate networks when it has been called to handle a "Network Transition Event". It is also important to realize that the "Network Transition Event" can be called as the result of an interrupt, so a client should obey all of the normal conventions involved at being called at this time (i.e. don't ask for memory from the memory manager, etc.).
The following information assumes you have already installed yourself into the AppleTalk transition queue.
ATTransNetworkTransition
The ATTransNetworkTransition event will be generated whenever a network transition occurs. You will be passed the following information using C calling conventions:
NetValidProcPtr netValidProc; // pointer to the network valid proc
Boolean newConnectivity; // true=new connectivity, false=loss of connectivity
} TNetworkTransition;
To check a network number for validity the client uses the netValidProc to call Remote Access. This call is defined as follows:
long netValidProc(TNetworkTransition *thetrans, unsigned long theAddress);
thetrans ---> pass in the TNetworkTransition struct given to you when your
transition handler was called.
theAddress ---> this is the network address you want checked. The format of theAddress is the same as for the struct AddrBlock as defined in AppleTalk.h:
#define ERR_LTM_CONNECT_TIMEDOUT (ERR_LTM_BASE-25) // Connection time out.
#define ERR_LTM_NO_DEFAULTS (ERR_LTM_BASE-26) // Could not get default info...
#define ERR_LTM_GOOD_BYE (ERR_LTM_BASE-27) // The driver is going away in a
// rude fashion
d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
< ° d ONLN d H H ä w ( y H
° d ONLN d r w Ä Å +/®
° d ONLN d ã H § ç ( ù HApple
° d ONLN d ç ç õ ê ( ó ç
° d ONLN d ã ê §= +
Remote Access ° d ONLN d § H Ω
( ∂ H'Application Programming Interface (API) ° d ONLN d ? Ω H ÷µ *!External Reference Specifications
° d ONLN d a  H ÛÍ * ENote: The Apple Remote Access API provides an application programming ° d ONLN d ß Û H *Qinterface to the Remote Access Manager. It supports calls to load and unload the ° d ONLN d ˘ H˛ *KRemote Access Manager (RAM), create and terminate connections, retrieve the ° d ONLN dE H ˘ *Ocurrent RAM status, and to determine if a specified network address is local or ° d ONLN dï H+ˆ *Mremote. Optionally, the Apple Remote Access API can display a user interface ° d ONLN d„+ H9
*Rshowing the process of a connection. The parameters for the connect call can be a ° d ONLN d69 HG *Oconnection document, created with the Remote Access application. The parameters ° d ONLN dÜG HU *Qof the connection, however, may not be specified out right when connecting to ARA ° d ONLN dÿU Hc *X2.0. These specifications also include how to tell if Apple Remote Access is installed, ° d ONLN d1c Hq *Pand how to deal with the serial port when Apple Remote Access is in answer mode.
° d ONLN dÇ HÏ *°BAlthough every attempt has been made to verify the accuracy of the ° d ONLN d≈ H" *Iinformation presented, this document may contain errors and is subject to ° d ONLN d" H2g *-change. ARA 2.0 features are not guaranteed.
+H√1 ˇ
Æ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
° d ONLN d H H X } ( T HGestalts
° d ONLN d f H t
* QWhen fully installed, Remote Access defines several new gestalt selectors. Below ° d ONLN d [ t H ÇV *1are the new defines and explanation of their use. ° d ONLN d ç ã H ôË *RTo see if serial port arbitration is installed, call _Gestalt using these defines. ,
Courier
° d ONLN d ‡ £ H Æ *#define gestaltArbitorAttr ° d ONLN d ˛ £D Æb )¸'arb ' ° d ONLN d ≠ H ∏ ( µ H&#define gestaltSerialArbitrationExists ° d ONLN d- ≠D ∏I )¸0
° d ONLN d/ ≈ H ” ê ( œ H For example:
° d ONLN d< ” H fi u * OSErr io; ° d ONLN dF › H Ë` *
8// check to see if serial port arbitrating is installed… ° d ONLN d Á H Ú â *
Kif ( ((io == noErr) && (attribs & (1 << gestaltSerialArbitrationExists))) ) ° d ONLN d H \ *
{ ° d ONLN d
H Ú *
" // have serial port arbitration ° d ONLN d- H$ \ *
} ° d ONLN d2# H. \ *
else ° d ONLN d7- H8 \ *
{ ° d ONLN d<7 HB Ë *
// no serial port arbitration ° d ONLN d]A HL \ *
}
° d ONLN dbU Hc *LMore information on serial port arbitration is discussed in a section below. ° d ONLN dØq HË * LTo see if Remote Access Connection Interface is available use these defines:
° d ONLN d¸â Hî „ * #define gestaltRemoteAccessAttr ° d ONLN d âDîb )¸'strm' ° d ONLN d%ì Hû Ì (õ H!#define gestaltRemoteAccessExists ° d ONLN dIìDûI )¸0
° d ONLN dK± Hø˜ (ª HMTo check if Remote Access support is available in the Alias Manager use these ° d ONLN dôø HÕ s *defines:
° d ONLN d¢◊ H‚ ‘ * #define gestaltAliasMgrAttr ° d ONLN d¡◊D‚b )¸'alis' ° d ONLN d»◊h‚˘ )$ // as defined in GestaltEqu.h ° d ONLN dÊ· HÏ. (È H.#define gestaltAliasMgrSupportsRemoteAppletalk ° d ONLN d·DÏI )¸1
° d ONLN dı Hà (ˇ H;To use ARA 2.0 features, call _Gestalt using these defines.
° d ONLN dS H ˜ *##define gestaltRemoteAccessCallOnly ° d ONLN dyD I )¸1 ° d ONLN d{h ‡ )$// checks for ARA client ° d ONLN dî H& ˜ (# H##define gestaltRemoteAccessMPServer ° d ONLN d∫D&I )¸2 ° d ONLN dºh& )$#// checks for ARA multi-port server ° d ONLN d‡% H0 Ë (- H #define gestaltRemoteAccessVers2 ° d ONLN d%D0I )¸3 ° d ONLN d%h0˛ )$ // checks for ARA 2.0 features
° d ONLN d$C HS ’ (O HSerial Port Arbitration
° d ONLN d<a Ho * QWhen installed Remote Access provides serial port arbitration throught the Serial ° d ONLN déo H}Ì *MPort Arbitrator tool. All serial drivers registered with the Communications ° d ONLN d‹} Hãö *>Resource Manager are arbitrated by the Serial Port Arbitrator. ° d ONLN d ô Hߨ * ETo check to see if the Serial Port Arbitrator is installed, check the
° d ONLN d°ßuµÊ )Z Gestalt selector (see ° d ONLN dπµ H√• (ø HB“Gestalts” section for these defines and an example of this call).
+H22 ˇ ¥ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
° d ONLN d V H d ( ` HTIf serial port arbitration is present, call OpenDriver when you want to use a serial ° d ONLN d U d H r
*Tport. If the driver requested is not open, OpenDriver will return a result of noErr ° d ONLN d ™ r H Ä *Rand the reference number of the driver. If the driver requested is open (in use), ° d ONLN d ˝ Ä H é *!OpenDriver will return the error ,
Courier
° d ONLN d Ç ç/ )∫ portInUse
° d ONLN d' Ä/ é )-*. When you are finished using the driver, ° d ONLN dR é H ú˝ ( ò HNcall CloseDriver. OpenDriver and CloseDriver calls should always be balanced, ° d ONLN d¢ ú H ™ *Salthough the Serial Port Arbitrator will protect against multiple open/close calls. ° d ONLN d˜ ∏ H Δ * TIf serial port arbitration is not present, do not use OpenDriver to determine if the ° d ONLN dL Δ H ‘Ú *Odriver is open. It will return you a result of noErr and the reference number, ° d ONLN dú ‘ H ‚ *Tallowing you access to a driver that another application is using. To determine if ° d ONLN dÒ ‚ H *Qthe serial driver requested is open by another application, you must walk the DCE ° d ONLN dC H ˛ *T(Device Control Entry) unit table (see Device Driver chapter of Inside Macintosh vol ° d ONLN dò ˛ H W *II). ° d ONLN dù H( * VIt is important to use the new method if serial port arbitration is available. Remote ° d ONLN dÙ( H6 *WAccess, when set up for answering calls, is passively using a particular serial driver. ° d ONLN dM6 HD *TIf you use the new method, the Serial Port Arbitrator will give up the passive claim ° d ONLN d¢D HR *Rand allow your OpenDriver call to return noErr. Later, when you call CloseDriver, ° d ONLN dıR H`Ï *IRemote Access will again passively claim the port and setup the modem for ° d ONLN d?` Hn Ö *
answering. ° d ONLN dKw HÖ *RBelow is a code example in C illustrating how to use serial port drivers under the ° d ONLN dûÖ Hì ƒ *new and old methods:
° d ONLN d≥ß H≤ ª * #include <GestaltEqu.h> ° d ONLN dÀ± Hº ß *
#include <SysEqu.h> ° d ONLN dflª HΔ ¨ *
#include <Devices.h> ° d ONLN dÙœ H⁄ ¢ *#include <stdio.h> ° d ONLN d„ HÓ œ *#define gestaltArbitorAttr ° d ONLN d%„ Ó> )ÿ'arb ' ° d ONLN d,Ì H¯ (ı H&#define gestaltSerialArbitrationExists ° d ONLN dSÌ ¯% )ÿ0 ° d ONLN dU˜ H ù (ˇ H#define dRAMBased ° d ONLN dk˜ > )ÿ0x0040 ° d ONLN dr H ì ( H#define dOpened ° d ONLN dÜ > )ÿ0x0020 ° d ONLN dç H ( H%Boolean SerialArbitrationExists(void) ° d ONLN d≥ H* M *
{ ° d ONLN d∂) Z4 n +
long ° d ONLN dª) ~4 ´ )$ response; ° d ONLN dΔ3 Z> s (; ZOSErr ° d ONLN dÃ3 ~> í )$err; ° d ONLN d‘G ZR; (O Z-err = Gestalt(gestaltArbitorAttr, &response); ° d ONLN dQ Z\ Ç *
if (err) ° d ONLN d[ lf ≠ +
return false; ° d ONLN d e Zp| (m Z:return ((response >> gestaltSerialArbitrationExists) & 1); ° d ONLN dXo Hz M (w H}
+Hz3 ˇ æ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d R H ] ( Z H*Boolean DriverIsOpen(StringPtr driverName) ° d ONLN d + \ H g M *
{ ° d ONLN d . f l q ‰ +$
Boolean canOpen = false; ° d ONLN d H p l { ⁄ *
Boolean match = false; ° d ONLN d ` z l Ö Ö *
short ° d ONLN d f z ê Ö ¬ )$
index = 0; ° d ONLN d r Ñ l è Ö ( å lshort ° d ONLN d x Ñ ê è Æ )$count; ° d ONLN d Ä é l ô û ( ñ l
DCtlHandle ° d ONLN d ã é ¥ ô Ê )H
dceHandle; ° d ONLN d ó ò l £ ô ( † l StringPtr ° d ONLN d ° ò ¥ £ ‹ )HnamePtr; ° d ONLN d ´ ¢ l ≠ û ( ™ l
DCtlHandle ° d ONLN d ∂ ¢ ¥ ≠ ˙ )H*theUnitTable; ° d ONLN d » ∂ l ¡± ( æ lA// this is the low memory global containing the number of entries ° d ONLN d ¿ l À – *
// in the Unit Table ° d ONLN d" l ’ *
count = *(short *)UnitNtryCnt; ° d ONLN dD fi l È> **theUnitTable = *(DCtlHandle **)UTableBase; ° d ONLN dr Ú l ˝ *$while ( !match && (index < count)) { ° d ONLN dô ¸ êS +$
'// get handle to a device control entry ° d ONLN d√ ê0 *
dceHandle = theUnitTable[index]; ° d ONLN dÈ ê% ‡ *if (dceHandle) { ° d ONLN d˝$ ¥/ï +$
index++; ° d ONLN dÌ∞ lª q (∏ l} ° d ONLN d∫ l≈ ∑ *
return canOpen; ° d ONLN d ƒ Hœ M (à H} ° d ONLN dÿ H„ *Boolean CRMInstalled(void) ° d ONLN d ‚ HÌ M *
{ ° d ONLN d Ï l˜ Ä +$
long ° d ONLN d%Ï ê˜ Ω )$ response; ° d ONLN d0ˆ l Ö (˛ lOSErr ° d ONLN d6ˆ ê § )$err; ° d ONLN d>
l9 ( l)err = Gestalt(gestaltCRMAttr, &response); ° d ONLN di l î *
if (err) ° d ONLN dt ê) — +$
return false; ° d ONLN dÉ( l3M (0 l-return ((response >> gestaltCRMPresent) & 1); ° d ONLN d±2 H= M (: H} ° d ONLN d≥F HQ f *Str255 ° d ONLN d∫F lQ )$ gDriverNames[] = {"\p.NoDrvr", ° d ONLN d‡P [\ +¥
"\p.AOut", ° d ONLN dÙZ eW *
"\p.BIn", ° d ONLN dd o\ *
"\p.BOut", ° d ONLN dn yk *
"\p.AppleCD", ° d ONLN d0x ÉW *
"\p.MPP", ° d ONLN dBÇ çf *
"\p.ASYC00", ° d ONLN dWå óR *
"\p.AIn" ° d ONLN dhñ °/ *
};
(Ò ê4 ˇÍ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d H H S ù ( P H#define TEST_CALL ° d ONLN d R H ] f *
main() ° d ONLN d \ H g M *
{ ° d ONLN d f l q Ö +$
OSErr ° d ONLN d " f ê q à )$ err = noErr; ° d ONLN d 0 p l { Ö ( x lshort ° d ONLN d 6 p ê { ö )$i; ° d ONLN d : z l Ö Ö ( Ç lshort ° d ONLN d @ z ê Ö « )$ numDrivers; ° d ONLN d O é l ô* ( ñ l&printf("Test of serial port stuff\n"); ° d ONLN d w ò l £ À *
if (CRMInstalled()) ° d ONLN d ç ¢ ê ≠≠ +$
9printf("Communication Resource Manager is installed.\n"); ° d ONLN d » ¨ l ∑ ( ¥ l if (SerialArbitrationExists()) ° d ONLN d È ∂ ê ¡N +$
&printf("Serial Arbitration exists\n"); ° d ONLN d H ’ ò ( “ H#ifdef TEST_CALL ° d ONLN d% ‘ l flk +$
3numDrivers = sizeof(gDriverNames) / sizeof(Str255); ° d ONLN dZ fi l È *
for (i = 0; i < numDrivers; i++) ° d ONLN d} Ë ê Ûb +$
*printf("DriverIsOpen(%#s)\treturned %s\n", ° d ONLN d≠ Ú ÿ ˝ +H
@gDriverNames[i], DriverIsOpen(gDriverNames[i])?"True ":"False"); ° d ONLN dÓ ¸ H f ( H#endif ° d ONLN dı H ò *#ifdef TEST_OPEN ° d ONLN d l% Ö +$
short ° d ONLN d
ê% ≥ )$refNum; ° d ONLN d. l9 ¯ (6 l if (!DriverIsOpen("\p.AIn")) ° d ONLN d58 êCD +$
$err = OpenDriver("\p.AIn", &refNum); ° d ONLN d[B lM î (J lif (err) ° d ONLN dfL êWX +$
(printf("OpenDriver returned %d\n", err); ° d ONLN dêV la Ó (^ lerr = CloseDriver(refNum); ° d ONLN d¨` lk î *
if (err) ° d ONLN d∑j êu] +$
)printf("CloseDriver returned %d\n", err); ° d ONLN d·t H f (| H#endif ° d ONLN dË~ Hâ M *
}
(Ò ê5 ˇ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
° d ONLN d H H X ‰ ( T HApple Remote Access API ° d ONLN d f H v œ * Common Parameters
° d ONLN d * v H Ñ *LThe TRemoteAccessParamBlock is a union of all of the available Apple Remote ° d ONLN d w Ñ H í *LAccess API commands. The TRemoteAccessParmHeader is a struct which consists ° d ONLN d ƒ í H † *Lof a DControlParamHeader followed by a DExtendedParam which is followed by a ° d ONLN d † H ÆÛ *HDRemoteAccessParmHeader. The extendedCode is used to specify the Apple ° d ONLN dZ Æ H º *RRemote Access API command wanted. The resultStrPtr field returns a Pascal string ° d ONLN d≠ º H *Yto indicate what error occurred. If you are not interested in the string, set this field ° d ONLN d H ÿ *Zto nil. If you do pass a pointer however, it must point to a buffer of at least 256 bytes ° d ONLN db ÿ H Ê *Vin length. If the result of the call happens to be noErr, then the length byte of the ° d ONLN dπ Ê H Ù *Sstring will be zero. Since this version of Remote Access only deals with the user ° d ONLN d
Ù H *Rport, the parameter portGlobalsPtr should always be set to zero. The csCode field ° d ONLN d` H *Gshould normally set to RAM_EXTENDED_CALL and the extendedType is set to ° d ONLN d® H *JREMOTEACCESSNAME. These constants are defined in RemoteAccessInterface.h. ,
Courier
° d ONLN dÛ, H7 Ÿ * #define DControlParamHeader \ ° d ONLN d6 dA } +
QElem ° d ONLN d6 êA ≥ ),*qLink; ° d ONLN d 6 ÿAA )H// next queue entry \ ° d ONLN d7@ dK } (H dshort ° d ONLN d=@ êK Æ ),qType; ° d ONLN dE@ ÿK# )H// queue type \ ° d ONLN dVJ dU } (R dshort ° d ONLN d\J êU ≥ ),ioTrap; ° d ONLN ddJ ÿU- )H// routine trap \ ° d ONLN dwT d_ s (\ dPtr ° d ONLN d{T ê_ ¬ ),
ioCmdAddr; ° d ONLN dÜT ÿ_< )H// routine address \ ° d ONLN dú^ di á (f dProcPtr ° d ONLN d§^ êi — ),
ioCompletion; ° d ONLN d≤^ ÿiK )H// completion routine \ ° d ONLN dÀh ds } (p dOSErr ° d ONLN d—h ês Ω ), ioResult; ° d ONLN d€h ÿs( )H// result code \ ° d ONLN dÌr d} x (z dlong ° d ONLN dÚr ê} Ω ), userData; ° d ONLN d¸r ÿ}P )H// for use by the user \ ° d ONLN d| dá } (Ñ dshort ° d ONLN d | êá ≥ ),unused; ° d ONLN d$| ÿá- )H// unused field \ ° d ONLN d7Ü dë } (é dshort ° d ONLN d=Ü êë Ω ), ioRefNum; ° d ONLN dGÜ ÿëd )H // driver reference number \ ° d ONLN deê dõ } (ò dshort ° d ONLN dkê êõ ≥ ),csCode; ° d ONLN dsê ÿõå )H$// normally set to RAM_EXTENDED_CALL ° d ONLN dûö ÿ•ë *
%// for Apple Remote Access API calls ° d ONLN dƒÆ Hπ ¿ (∂ H#define DExtendedParam \ ° d ONLN dfi∏ d√ Õ +
DControlParamHeader \ ° d ONLN dı¬ dÕ s *
Ptr ° d ONLN d˘¬ êÕ — ),
hReserved1; \ ° d ONLN dà d◊ s (‘ dPtr ° d ONLN d à ê◊ — ),
hReserved2; \ ° d ONLN d÷ d· s (fi dPtr ° d ONLN d ÷ ê· € ),resultStrPtr; \ ° d ONLN d/÷ Ù·À )d+// set to zero if result string is unwanted ° d ONLN d\‡ dÎ s (Ë dPtr ° d ONLN d`‡ êÎ — ),
extendedType; ° d ONLN do‡ ÙÎÈ )d1// pointer to identifier string, normally set to (˨6// REMOTEACCESSNAME for Apple Remote Access API calls ° d ONLN d›Ù Hˇ Ì (¸ H!#define DRemoteAccessParmHeader \ ° d ONLN d ˛ d ¥ +
DExtendedParam \ ° d ONLN d d } *
short ° d ONLN d ê — ),
extendedCode; ° d ONLN d' Ùû )d"// for use by extended call proc \ ° d ONLN dK d s ( dPtr ° d ONLN dO ê € ),portGlobalsPtr; ° d ONLN d_ Ù Ó )d2// pointer to globals for this port (0=userport) \ ° d ONLN dí& H1 fi (. H struct TRemoteAccessParmHeader ° d ONLN d±0 H; M *
{ ° d ONLN d¥: dE ◊ +
DRemoteAccessParmHeader ° d ONLN dÃD HO R (L H}; ° d ONLN dœN HYÉ *
?typedef struct TRemoteAccessParmHeader TRemoteAccessParmHeader; ° d ONLN db Hm Ÿ * union TRemoteAccessParamBlock ° d ONLN d-l Hw M *
{ ° d ONLN d0v dÅ ◊ +
TRemoteAccessParmHeader ° d ONLN dHv ¸Å )òHDR; ° d ONLN dNvDÅÄ )H // header pb ° d ONLN d\Ä dã ◊ (à dTRemoteAccessParmHeader ° d ONLN dtÄ ¸ã )òLOAD; ° d ONLN d{ÄDãv )H
// load pb ° d ONLN dáä dï ◊ (í dTRemoteAccessParmHeader ° d ONLN düä ¸ï )òUNLOAD; ° d ONLN dßäDïÄ )H // unload pb ° d ONLN dµî dü · (ú dTRemoteAccessConnectParam ° d ONLN dœî ¸ü$ )òCONNECT; ° d ONLN dÿîDüÖ )H
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d H d S · ( P d/* 2.0 and above only… */ ° d ONLN d R d ] √ *
T976SetOnlineNotify ° d ONLN d / R ÿ ] )t
ONLINE_NOTIFY ° d ONLN d = R ]ß )H// used to toggle the state ° d ONLN d ^ \ ¥ g ( d ¥// of notification ° d ONLN d r f d q • ( n d
unsigned char ° d ONLN d Å f ¥ q )P filler[256]; ° d ONLN d è f q¿ )l // set the minimum size of this ( n–// parameter block ° d ONLN d p H { R ( x H}; ° d ONLN d Õ z H Ö~ *
>typedef union TRemoteAccessParamBlock TRemoteAccessParamBlock; ° d ONLN d Ñ H èj *
° d ONLN dL ™ H ∏ *PThe load command is used to ensure that the Remote Access Manager is loaded into ° d ONLN dù ∏ H Δˆ *Lmemory and must be used before making a Connect call . It uses the standard ° d ONLN dÍ Δ H ‘ *LTRemoteAccessParmBlock as the parameter block. The example code below shows ° d ONLN d7 ‘ H ‚ *Nhow it works. To use the MungePW command, it is not necessary to use the load ° d ONLN dÜ ‚ H ù *command first.
° d ONLN dï ˛ H Ú *"#include “RemoteAccessInterface.h” ° d ONLN d∏ H ª *
void LoadRemoteAccess() ° d ONLN d– H M *
{ ° d ONLN d” R' Ì +
TRemoteAccessParamBlock loadPB; ° d ONLN dˆ0 R; *'loadPB.LOAD.csCode = RAM_EXTENDED_CALL; ° d ONLN d 0 ;p )Œ// extended call ° d ONLN d0: RE Ì (B R loadPB.LOAD.resultStrPtr = nil; ° d ONLN dP: ¸EL )™// result string ° d ONLN dbD RO. (L R,loadPB.LOAD.extendedType = REMOTEACCESSNAME; ° d ONLN dèDDO£ )Ú// to remote access ° d ONLN d§N RYB (V R0loadPB.LOAD.extendedCode = CmdRemoteAccess_Load; ° d ONLN d’NMYì )˚// try to load ° d ONLN dÂX Rc Ì (` R PBRemoteAccess(&loadPB, false); ° d ONLN dX ¸cV )™// issue sync call ° d ONLN db Rm œ (j Rif (loadPB.LOAD.ioResult) ° d ONLN d5l Zw ˙ +
ShowError(loadPB.LOAD.ioResult); ° d ONLN dVv HÅ M (~ H}
° d ONLN dXä Hö w *Unload
° d ONLN d_ö H® *LThe unload command is used to release the Remote Access Manager and free its ° d ONLN d¨® H∂ *Lmemory. It uses the standard TRemoteAccessParmBlock as the parameter block ° d ONLN d˘∂ Hƒ *Rand can be issued immediately after making a Connect call. This allows the Remote ° d ONLN dLƒ H“ *RAccess Manager to be unloaded as soon as an active connection is terminated with a ° d ONLN dü“ H‡ *Odisconnect, if no other clients have loaded Remote Access. Below is an example ° d ONLN dÔ‡ HÓ â * unload call.
° d ONLN d¸¯ H Ú *"#include “RemoteAccessInterface.h” ° d ONLN d H
≈ *
void UnloadRemoteAccess() ° d ONLN d9 H M *
{ ° d ONLN d< R! Ú +
TRemoteAccessParmBlock unloadPB; ° d ONLN d`* R5… *K// unload the code (will not actually go away till this connection is done) ° d ONLN d≠4 R?) *
+unloadPB.UNLOAD.csCode = RAM_EXTENDED_CALL; ° d ONLN dŸ4D?î )Ú// extended call ° d ONLN dÎ> RI (F R#unloadPB.UNLOAD.resultStrPtr = nil; ° d ONLN d> Ip )Œ// result string ° d ONLN d!H RSB (P R0unloadPB.UNLOAD.extendedType = REMOTEACCESSNAME; ° d ONLN dRH^SΩ (P^// to remote access ° d ONLN dgR R]` (Z R6unloadPB.UNLOAD.extendedCode = CmdRemoteAccess_Unload; ° d ONLN dûRh]∏ (Zh// try to unload ° d ONLN d∞\ Rg ˜ (d R!PBRemoteAccess(&unloadPB, false); ° d ONLN d“\ ¸gV )™// issue sync call ° d ONLN dÊf Rq „ (n R if (unloadPB.UNLOAD.ioResult) ° d ONLN dp [{ +
$ShowError(unloadPB.UNLOAD.ioResult); ° d ONLN d+z HÖ M (Ç H}
+Ho7 ˇB d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
° d ONLN d H H X } ( T HConnect
° d ONLN d X H f *UThis call is used to initiate an outgoing connection. When you are connected in this ° d ONLN d ^ f H t *Rmode you will still retain access to your current network. Network numbers are re ° d ONLN d ∞ f t ( p- ° d ONLN d ± t H Ç ( ~ HNmapped in a limited way in order to solve problems of network number conflicts ° d ONLN d Ç H ê *Qbetween the two machines being directly connected, thus ensuring they will always ° d ONLN dR ê H û *Ybe accessible to each other. Unfortunately, it is not possible to solve all of the other ° d ONLN d¨ û H ¨ *Tpossible conflicts due to the limited number of network numbers available. In order ° d ONLN d ¨ H ∫ *Sto provide a method of ensuring access to all networks on the destination network a ° d ONLN dU ∫ H » *Rguaranteed access method is available. When connected in this mode, you will lose ° d ONLN d® » H ÷˝ *Naccess to all services beyond those on the same single network number that the ° d ONLN d˜ ÷ H ‰ *Ucalling machine belongs to. In order to notify clients of the AppleTalk stack that a ° d ONLN dM ‰ H Ú *Nnetwork will no longer be reachable we have created a new AppleTalk Transition ° d ONLN dú Ú H ¸ *KQueue event. (See Network Transition Events later in this document.) When ° d ONLN dË H˘ *Lconnecting the client passes in a TRAConnectInfoTemplate, or the FSSpec of a ° d ONLN d5 H *Ldocument which contains the connect parameters. The connect parameter block ° d ONLN dÇ H* *Rcontains the optionFlags field which specifies the connect options. The flags are ° d ONLN d’* H8 ï * shown below: ,
Courier
° d ONLN d‚F HQ ª *// connect option flags ° d ONLN d˙P H[ ∂ *
#define kNSCanInteract ° d ONLN dP ◊[ )è
0x00000001 ° d ONLN d P[Ô )A+// User interaction (password prompt) is OK ° d ONLN dHZ He ± (b H#define kNSShowStatus ° d ONLN d^Z ◊e )è
0x00000002 ° d ONLN diZe )A4// show the status of the connect or disconnect call ° d ONLN dûd Ho (l H#define kNSConnectDocument ° d ONLN dπd ◊o )è
0x00000004 ° d ONLN dƒdo )A4// connect using the specified document using FSSpec ° d ONLN d˘n Hy ∂ (v H#define kNSPassWordSet ° d ONLN dn ◊y )è
0x00000010 ° d ONLN dny )A3// use the specified password field when connecting ° d ONLN dWxÉ^ *
// by document ° d ONLN dfÇ Hç ù (ä H// 2.0 and above… ° d ONLN dxå Hó ∂ *
#define kNS2SavvyFlags ° d ONLN dèå ◊ó )è
0x40000000 ° d ONLN döåó )A2// Set to use the next 2 flags below for only ARA (î–// 2.0 aware applications. ° d ONLN dÌñ H° ¿ (û H#define kNSAR2Connection ° d ONLN dñ ◊° )è
0x00000020 ° d ONLN dñ°Æ )A // connecting to a 2.0 server. ° d ONLN d1† H´ (® H*#define kNSNotifyWhileConnected 0x00000040 ° d ONLN d\† ´ )ÿ2// display cute notification icon while connected.
° d ONLN dè∏ HΔ˝ (¬ HOThe kNSCanInteract flag allows interaction with the user to get the password if ° d ONLN dflΔ H‘ *Unecessary or prompt the user to change their password if the server requires it. The ° d ONLN d5‘ H‚ *OkNSShowStatus flag enables the connection status display. The display is modal ° d ONLN dÖ‚ H *Ndialog which updates with new messages as the connection progresses. When the ° d ONLN d‘ H˛Ò *IkNSConnectDocument flag is set, the Apple Remote Access API will use the ° d ONLN d ˛ H *Pspecified ARA 2.0 document for the connect parameters (i.e. user name, password) ° d ONLN d o H *Nof the TRAConnectInfoTemplate. The document is specified by the FSSpec record ° d ONLN d æ H( *Kwhich contains vRefNum (volume reference number), parID (directory ID), and ° d ONLN d
( H6¸ *Mname (pointer to Pascal style string containing the document name). No other ° d ONLN d
X6 HDˇ *Lparameters need to be supplied. The kNSPassWordSet flag overrides the saved ° d ONLN d
•D HR *Lpassword when connecting by document or by PB and forces Apple Remote Access ° d ONLN d
ÚR H` *UAPI to use the passWord field in cleartext. If the kNSPassWordSet flag is clear and ° d ONLN d H` Hn *Rthe passwordSaved flag is set, then the client must supply a munged password. The ° d ONLN d õn H|˛ *KkNS2SavvyFlags is set if using ARA 2.0 features. The kNSAR2Connection flag ° d ONLN d Á| Hä *^indicates the connection is to a 2.0 server. If this bit is not set, it is assumed that it is ° d ONLN d Fä Hò *Oa 1.0 connection. The kNSNotifyWhileConnected flag will display a notification ° d ONLN d ñò H¶n *3icon on the Apple Menu while the user is connected. ° d ONLN d ¥ H¬„ * LIn this release, the client may not connect by parameter block (PB). Use the ° d ONLN d
¬ H– *IkNSConnectDocument flag to connect with a specified ARA 2.0 document. The
+H%8 ˇ8 d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d H H S Ÿ ( P H struct TRAConnectInfoTemplate ° d ONLN d R H ] M *
{ ° d ONLN d ! \ R g ¿ +
unsigned long version; ° d ONLN d 8 \ ÿ gU )Ü// version of this format ° d ONLN d S f R q ª ( n Runsigned long ltType; ° d ONLN d i f ÿ q- )Ü// Link Tool type ° d ONLN d | p R { ≈ ( x Rlong addressInfoLength; ° d ONLN d î p ÿ {å )Ü$// length of the address information ° d ONLN d ∫ z R Ö ± ( Ç RPtr addressInfoPtr; ° d ONLN d Œ z ÿ ÖÇ )Ü"// pointer to connect address info ° d ONLN d Ú Ñ R è Ì ( å R long ltSpecificTemplateLength; ° d ONLN d Ñ ¸ èø )™'// length of the ltspecific information ° d ONLN d; é R ô ‘ ( ñ RPtr ltSpecificTemplatePtr; ° d ONLN dV é ¸ ôø )™'// pointer to link tool specific params ° d ONLN d ò R £ ( † R(unsigned char passWord[PASSWORDBUFSIZE]; ° d ONLN d® ò £p )Œ// user password ° d ONLN d∫ ¢ R ≠ ( ™ R%unsigned char userName[USERNAMESIZE]; ° d ONLN d‡ ¢ ≠\ )Œ // user name ° d ONLN dÔ ¨ R ∑ ( ¥ R#unsigned long connectReminderTimer; ° d ONLN d ¨ ∑˜ )Œ+// value for connection reminder in seconds ° d ONLN d@ ∂ R ¡ ˜ ( æ R!unsigned long connectOKWaitTimer; ° d ONLN db ∂ ¸ ¡ÿ )™,// how long to wait for OK on reminder timer ° d ONLN dê ¿ R À ± ( » RBoolean guestLogin; ° d ONLN d§ ¿ ÿ À_ )Ü// try to log in as a guest ° d ONLN d¬ R ’ ¿ ( “ RBoolean passwordSaved; ° d ONLN dŸ ÿ ’_ )Ü// set if password is saved ° d ONLN d˜ ‘ R fl œ ( ‹ RBoolean guaranteedAccess; ° d ONLN d ‘ ÿ fl√ )Ü/// flag to guarantee access to servers internet ° d ONLN dA fi H È R ( Ê H}; ° d ONLN dD Ë H Ûy *
=typedef struct TRAConnectInfoTemplate TRAConnectInfoTemplate; ° d ONLN dÇ Ú H ˝` *
8typedef TRAConnectInfoTemplate *TPRAConnectInfoTemplate; ° d ONLN dª H Ë * struct TRemoteAccessConnectBlock ° d ONLN d‹ H M *
{ ° d ONLN dfl R% ≈ +
DRemoteAccessParmHeader ° d ONLN d¯$ R/ *
#TRAConnectInfoTemplate connectInfo; ° d ONLN d $ /fi )Œ&// The connection information template ° d ONLN dD. R9 ‘ (6 Runsigned long optionFlags; ° d ONLN d_. ¸9¶ )™"// bit mapped connect option flags ° d ONLN dÑ8 RC ¢ (@ RFSSpec fileInfo; ° d ONLN dï8 ¥CY )b!// file info for connect document ° d ONLN d∑B HM R (J H}; ° d ONLN d∫L HWó *
° d ONLN d˛` Hne *1The following is an example connection procedure:
° d ONLN d0z HÖ Ú *"#include “RemoteAccessInterface.h” ° d ONLN dSÑ Hè ò *
void DoConnect() ° d ONLN ddé Hô M *
{ ° d ONLN dgò R£ ¸ +
"TRemoteAccessParamBlock connectPB; ° d ONLN d㢠R≠à *
>Str255 PathName = “MyHardDisk:Remote Access:Connect Document”; ° d ONLN dÀ∂ R¡ ± *LoadRemoteAccess(); ° d ONLN dfl∂ ÿ¡x )Ü // Get the Remote Access Manager ° d ONLN d¿ lÀ ô (» l // loaded ° d ONLN d
R’3 (“ R-connectPB.CONNECT.csCode = RAM_EXTENDED_CALL; ° d ONLN d; D’î )Ú// extended call ° d ONLN dM‘ Rfl (‹ R%connectPB.CONNECT.resultStrPtr = nil; ° d ONLN ds‘ fl¨ )Œ // don’t want result strings ° d ONLN dëfi RÈV (Ê R4connectPB.CONNECT.extendedType = REMOTEACCESSNAME; ° d ONLN dΔfihÈ« (Êh// to Remote Access ° d ONLN d€Ë RÛy ( R;connectPB.CONNECT.extendedCode = CmdRemoteAccess_DoConnect; ° d ONLN dËåÛÎ (å // connect command ° d ONLN d,Ú R˝ (˙ R'connectPB.CONNECT.portGlobalsPtr = nil; ° d ONLN dTÚ ˝Ñ )Œ// use the user port ° d ONLN dj¸ R ( R'connectPB.CONNECT.fileInfo.vRefNum = 0; ° d ONLN dí¸ ò )Œ// Use the full pathname ° d ONLN d¨ R ( R%connectPB.CONNECT.fileInfo.parID = 0; ° d ONLN d” RQ *
3strcpy(&PathName,&connectPB.CONNECT.fileInfo.name); ° d ONLN dh (h#// copy the string to fileInfo.name ° d ONLN d,$ R/‚ (, RP// Ask for password if needed, use connection document, & show connection status ° d ONLN d~. R9Ò *
) | kNS2SavvyFlags ° d ONLN d˝8DCΔ )Ú// Use the 2.0 flags below ° d ONLN d B RM. (J R, | kNSAR2Connection ° d ONLN d FBDM’ )Ú // connection to a 2.0 server ° d ONLN d dL HWQ (T H5 | kNSNotifyWhileConnected; ° d ONLN d öLhW (Th // displaying notification icon ° d ONLN d ªV Ra (^ R$PBRemoteAccess(&connectPB, false); ° d ONLN d ‡V az )Œ// issue sync call ° d ONLN d Ù` Rk Ì (h R if (connectPB.CONNECT.ioResult) ° d ONLN d
j Ru *
) ShowError(connectPB.CONNECT.ioResult); ° d ONLN d
?jDuÓ )Ú"// Do Error reporting and recovery ° d ONLN d
ct R ª (| RUnloadRemoteAccess(); ° d ONLN d
yt ÿd )Ü // Unload when disconnected. ° d ONLN d
ñ~ Hâ é (Ü H} // DoConnect
+Hk10 ˇ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
° d ONLN d H H X é ( T H
Disconnect
° d ONLN d X H f *RThe disconnect command is used to terminate an existing session or cancel one that ° d ONLN d ^ f H t *Uis being created. If you only want to disconnect a session that was connected with a ° d ONLN d ¥ t H Ç *Rspecific parameter block you can do so by setting a pointer to the parameter block ° d ONLN d Ç H ê‡ *Jused to issue the connect in abortOnlyThisPB. If you want to disconnect a ° d ONLN dR ê H û *Tconnection created by anyone, you set the abortOnlyThisPB field to zero. If you are ° d ONLN dß û H ¨ *Udisconnecting an outgoing call, you pass zero in portGlobalsPtr. Disconnecting ports ° d ONLN d˝ ¨ H ∫ *Qother than the userport, is not supported in this version. You should always set ° d ONLN dO ∫ H » *Kdisconnectin to zero. The option kNSShowStatus will cause the Apple Remote ° d ONLN dõ » H ÷õ *?Access API to display the status dialog during the disconnect. ,
Courier
° d ONLN d€ ‰ H Ô Ÿ * #define kNumWarnEntriesMax 5 ° d ONLN d˘ ‰ ¸ Ô¶ )¥"// number of entries in warn array ° d ONLN d Ó H ˘ ˜ ( ˆ H#struct TRemoteAccessDisconnectParam ° d ONLN d@ ¯ H M *
{ ° d ONLN dC R
≈ +
DRemoteAccessParmHeader ° d ONLN d\ R Ÿ *
unsigned long disconnectin; ° d ONLN dx ¸ú )™ // Note: Set this parameter to 0 ° d ONLN dö R! ( R)TPRemoteAccessParamBlock abortOnlyThisPB; ° d ONLN dƒ1!
)fl,// only abort a connection opened by this pb ° d ONLN dÚ R+) (( R+unsigned long warnArr[kNumWarnEntriesMax]; ° d ONLN d 1+ )fl.// set warn times here in seconds (zero all if ° d ONLN dO* l5 ∑ (2 l// no warnings) ° d ONLN dd4 R? ‘ (< Runsigned long optionFlags; ° d ONLN d4 ¸?¶ )™"// bit mapped connect option flags ° d ONLN d¢> HI R (F H}; ° d ONLN d•H HSµ *
%TRemoteAccessParamBlock disconnectPB; ° d ONLN d√º R« Ë * // set up the Remote Access PB ° d ONLN d„Δ R—Q *
3disconnectPB.DISCONNECT.csCode = RAM_EXTENDED_CALL; ° d ONLN dΔh—∏ (Œh// extended call ° d ONLN d*– R€) (ÿ R+disconnectPB.DISCONNECT.resultStrPtr = nil; ° d ONLN dW–_€Î (ÿ_ // don’t want result strings ° d ONLN du⁄ RÂj (‚ R8disconnectPB.DISCONNECT.extendedType = REMOTEACCESSNAME; ° d ONLN dØ⁄∞ (‚∞ // to Remote Access ° d ONLN d≈‰ RÔ (Ï RYdisconnectPB.DISCONNECT.extendedCode = CmdRemoteAccess_Disconnect; // disconnect command ° d ONLN d Ó R˘3 *
-disconnectPB.DISCONNECT.portGlobalsPtr = nil; ° d ONLN dOÓ_˘õ (ˆ_ // user port ° d ONLN d]¯ R8 ( R.disconnectPB.DISCONNECT.abortOnlyThisPB = nil; ° d ONLN dç¯_ ( _$// don't get tied to any specific pb ° d ONLN d≥ R
e (
R7disconnectPB.DISCONNECT.optionFlags = 0| kNSShowStatus; ° d ONLN dÎå
(
å// show status while ° d ONLN d H â ( H
disconnecting ° d ONLN d R! +
%PBRemoteAccess(&disconnectPB, false); ° d ONLN d6D!û )Ú// issue sync call ° d ONLN dJ R+ (( R%if (disconnectPB.DISCONNECT.ioResult) ° d ONLN dq* R5= *
/ ShowError(disconnectPB.DISCONNECT.ioResult); ° d ONLN d¢*_5 (2_"// Do Error reporting and recovery ° d ONLN d≈4 H? M (< H}
+Hµ11 ˇl d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
'Bytes 3 & 2 (High Word): Network Number ° d ONLN dÆ ∫ R » À *Byte 1: Node Number ° d ONLN d√ » R ÷ * Byte 0 (Low Byte): Socket Number ° d ONLN d‰ ‰ H Ú ( Ó HTThe optionFlags parameter is used for getting, or disposing, connection information. ° d ONLN d: Ú H ˜ * The following flags are defined: ,
Courier
° d ONLN d] H ‘ * #define ctlir_getConnectInfo ° d ONLN dz ¸ )¥0x01 ° d ONLN d Ú )$*// will get connect info if address remote ° d ONLN d™ H# Ì ( H!#define ctlir_disposeConnectInfo ° d ONLN dà ¸# )¥0x02 ° d ONLN d— # )$/// will dispose info in connectInfoPtr properly
° d ONLN d0 H>Ì (: HOIf the ctlir_getConnectInfo flag is set, and the network address is remote, the ° d ONLN dQ> HL‹ *Jinformation necessary to create the remote connection is returned. If the ° d ONLN dúL HZ *Uctlir_disposeConnectInfo flag is set, the connect information structure pointed to by ° d ONLN dÚZ Hh *(connectInfoPtr, is disposed of properly. ° d ONLN dv HÑ * QThe locationIsRemoteFlag parameter is a flag that is returned true if the network ° d ONLN dmÑ Hí *Oaddress is remote. The connectInfoLength parameter indicates the length of the ° d ONLN dΩí H† *Sconnect information. The connectInfoPtr is a pointer to the connection information ° d ONLN d† HÆÛ *Kfor connecting with the remote address. These values are returned when the ° d ONLN d]Æ Hº∏ *Dnetwork address is remote, and the ctlir_getConnectInfo flag is set.
° d ONLN d§ H’ Ì *!struct TRemoteAccessIsRemoteParms ° d ONLN dΔ‘ Hfl M *
{ ° d ONLN d…fi RÈ ≈ +
DRemoteAccessParmHeader ° d ONLN d‚Ë RÛ ß *
long theAddress; ° d ONLN dˆË ¸Ûú )™ // address that is to be checked ° d ONLN dÚ R˝ ‘ (˙ Runsigned long optionFlags; ° d ONLN d3Ú ¸˝° )™!// Set to ctlir_getConnectInfo or ° d ONLN dW¸ l\ ( l0// ctlir_disposeConnectInfo, if zero only checks ° d ONLN dä l ≠ *
// theAddress ° d ONLN dô R „ ( R Boolean locationIsRemoteFlag; ° d ONLN d∑ ¸∞ )™$// returns true if address is remote ° d ONLN d› R% ≈ (" Rlong connectInfoLength; ° d ONLN dˆ ¸%ó )™ // length of the following data ° d ONLN d$ R/ (, R'TPRAConnectInfoTemplate connectInfoPtr; ° d ONLN d@$ / )Œ.// The connection information template pointer ° d ONLN dp. H9 R (6 H}; ° d ONLN ds8 HC° *
° d ONLN d¿` Hn˘ *JThe status command is used to obtain information about Remote Access. The ° d ONLN d n H| *Minformation you can obtain is how long a connection has been active, how much ° d ONLN dY| Hä˙ *Ktime remains in the connection, the name of the user that made an answering ° d ONLN d•ä Hò *Rconnection, the name of the computer you are connected to on a calling connection, ° d ONLN d¯ò H¶ *Tand the last message that was posted. The statusBits parameter is used to determine ° d ONLN d M¶ H¥‹ *Nif a connection is active, starting up, in the process of tearing down, if the ° d ONLN d ú¥ H¬¸ *Oconnection is an answering or calling connection, if the computer is enabled to ° d ONLN d Ϭ H– *Xreceive answer calls or if a disconnect is in progress. The following flags are defined:
+H%12 ˇ“ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d V H a Ì ( ^ H!// bits passed back in statusBits ° d ONLN d " ` H k *
*#define CctlConnected 0x00000001 ° d ONLN d M ` kâ )ÿ// set when connected ° d ONLN d c j H u ( r H*#define CctlAnswerEnable 0x00000004 ° d ONLN d é j ufi )ÿ&// set when we are set to answer calls ° d ONLN d µ t H ( | H*#define CctlServerMode 0x00000008 ° d ONLN d ‡ t ˜ )ÿ+// set for answer mode, clear for call mode ° d ONLN d ~ H â ( Ü H*#define CctlConnectionAborting 0x00000010 ° d ONLN d7 ~ â¿ )ÿ // connection is being torn down ° d ONLN dX à H ì ( ê H*#define CctlConnectInProg 0x00000020 ° d ONLN dÉ à ì˜ )ÿ+// set when connection in progress or fully ° d ONLN d∑ í ù\ *
// connected ° d ONLN dƒ ú H ß ( § H*#define CctlDisconnectInStarted 0x00008000 ° d ONLN dÔ ú ßfi )ÿ&// somebody has started a disconnectIn ° d ONLN d ¶ H ± ( Æ H*#define ctlAR2Connection 0x02000000 ° d ONLN dA ¶ ± )ÿ.// set when this connection is to a 2.0 server ° d ONLN dp ∞ H ª ( ∏ H*#define ctlNotifyWhileConnected 0x04000000 ° d ONLN dõ ∞ ª )ÿ0// set when the user wants to be reminded while ( ∏d
// connected. ° d ONLN d‹ ∫ H ≈ ( ¬ H*#define ctlConnectedToMPS 0x08000000 ° d ONLN d ∫ ≈ )ÿ0// set when client is connected to a multi-port ( ¬d // server ° d ONLN dD ƒ H œ ( à H*#define CctlMultiNodeReady 0x80000000 ° d ONLN do ƒ œÚ )ÿ*// shows if we currently have a multinode ( Ãà!// address to enable answer mode.
° d ONLN d¿ ÿ H Êx ( ‚ H7The following struct is used when making a status call:
° d ONLN d¯ Ú H ˝ „ * struct TRemoteAccessStatusParam ° d ONLN d ¸ H M *
// non nil ° d ONLN dL RWÁ (T RQTPRemoteAccessParamBlock connectedByParamPtr; // a pointer to the parameter block ° d ONLN dlV la9 +
)// "initiating" the connection if we are ° d ONLN döV‘a (^‘ // connected ° d ONLN d®` Rk (h RWTPRemoteAccessParamBlock statusConnectedByParamPtr; // a pointer to the parameter block ° d ONLN dj luR +
.// "initiating" the connection when status was ° d ONLN d3t l ô *
// posted ° d ONLN d>~ Râ (Ü R$unsigned char *theLastStatusMsgPtr; ° d ONLN dc~!â⁄ )œ%// expects pointer to buffer of size (Üà// MAXSTATUSMSGSIZE ° d ONLN d¢à Rì ¸ (ê R"unsigned char *statusUserNamePtr; ° d ONLN d≈à!ìÓ )œ)// pointer to buffer of size USERNAMESIZE ° d ONLN dí Rù ± (ö Rlong statuslttype; ° d ONLN dí ÿù- )Ü// link tool type ° d ONLN dú Rß Ÿ (§ Rlong statusmsgOptionFlags; ° d ONLN d3ú ¸ß° )™!// classification of message type ° d ONLN dV¶ R± ± (Æ Rlong statusMsgNum; ° d ONLN dj¶ ÿ±Z )Ü// specific message number ° d ONLN dÜ∞ Rª ¿ (∏ Rlong statusMsgSeqNum; ° d ONLN dù∞ ÿªÕ )Ü1// pass in zero if always want status, otherwise (∏@/// use last value, if status is new, new number ° d ONLN d ∫ l≈ ≤ (¬ l// is returned ° d ONLN d ƒ Rœ „ (à R unsigned long userSignature; ° d ONLN d 2ƒ ¸œà )™ // signature of port creator ° d ONLN d PŒ RŸ ‘ (÷ Runsigned long userRefCon; ° d ONLN d kŒ ¸Ÿy )™// refcon of port creator ° d ONLN d Öÿ H„ R (‡ H}; ° d ONLN d à‚ HÌç *
° d ONLN d ˆ H≈ *EAn example status call that determines the state Remote Access is in.
° d ONLN d
H Ú *"#include “RemoteAccessInterface.h” ° d ONLN d
3 H# ò *
void GetStatus() ° d ONLN d
D" H- M *
{ ° d ONLN d
G, Q7 ˆ +
!TRemoteAccessParamBlock statusPB; ° d ONLN d
j6 QA *
(Str255 UserName,connectedTo,lastMessage; ° d ONLN d
î@ QK ° *
long statusBits; ° d ONLN d
¶T Q_( *+statusPB.STATUS.csCode = RAM_EXTENDED_CALL; ° d ONLN d
“TD_î )Û// extended call ° d ONLN d
‰^ Qi (f Q#statusPB.STATUS.resultStrPtr = nil; ° d ONLN d ^ i )œ// put results here ° d ONLN d h Qs
(p Q%statusPB.STATUS.portGlobalsPtr = nil; ° d ONLN d Ch sf )œ// do UserPort ° d ONLN d Sr Q}A (z Q0statusPB.STATUS.extendedType = REMOTEACCESSNAME; ° d ONLN d Ñr_}• (z_// to Netshare ° d ONLN d î| Qái (Ñ Q8statusPB.STATUS.extendedCode = CmdRemoteAccess_Status; ° d ONLN d Õ|åá· (Ñå// status command ° d ONLN d ‡Ü Që (é Q(statusPB.STATUS.userNamePtr = &UserName; ° d ONLN d
ê QõK *
2statusPB.STATUS.connectedToNamePtr = &connectedTo; ° d ONLN d >ö Q•P *
3statusPB.STATUS.theLastStatusMsgPtr = &lastMessage; ° d ONLN d s§ QØ *
(statusPB.STATUS.statusUserNamePtr = nil; ° d ONLN d ùÆ Qπ *
$statusPB.STATUS.statusMsgSeqNum = 0; ° d ONLN d ƒ∏ Q√ ˆ *
!PBRemoteAccess(&statusPB, false); ° d ONLN d Á¬ QÕ ‚ *
if (statusPB.STATUS.ioResult)
+?'13 ˇ" d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d H Q S [ ( P Q ° d ONLN d H c S )%ShowError(statusPB.STATUS.ioResult); ° d ONLN d ) HD SÓ )·"// Do Error reporting and recovery ° d ONLN d M R Q ] e ( Z Qelse ° d ONLN d S \ Q g V *
{ ° d ONLN d X f c q! +
&// now decode the flag bits into words ° d ONLN d Ç p c {+ *
(statusBits = statusPB.STATUS.statusBits; ° d ONLN d Æ z c Ö *
if (statusBits & CctlServerMode) ° d ONLN d ” Ñ l è +
printf("Answer connection\n"); ° d ONLN d ı é c ô ˛ ( ñ c if (statusBits & CctlConnected) ° d ONLN d ò l £ +
printf("Calling connection\n"); ° d ONLN d< ¢ c ≠+ ( ™ c(if (statusBits & CctlConnectionAborting) ° d ONLN di ¨ l ∑ +
printf("Cancel in progress\n"); ° d ONLN då ∂ c ¡
( æ c"if (statusBits & CctlAnswerEnable) ° d ONLN d≥ ¿ l À* +
&printf("Waiting for incoming call\n"); ° d ONLN d› c ’ ( “ c#if (statusBits & CctlConnectInProg) ° d ONLN d ‘ l fl +
#printf("Connection in progress\n"); ° d ONLN d* fi R È W ( Ê R} ° d ONLN d, Ë H Û é ( H} // GetStatus
° d ONLN d; H" › *.GetUserPortGlobalsPtr
° d ONLN dQ" H0 *TIn order to make the RAM Status call on a machine that is setup to answer calls, you ° d ONLN d¶0 H> *Wmust first make the GetUserPortGlobalsPtr call to retrieve a pointer to the globals for ° d ONLN d˛> HL í *the user port. ° d ONLN d
Z Hh„ * FThe Apple Remote Access (ARA) Personal software supports dial-out and ° d ONLN dTh Hv
*Qanswering capabilities through a single port called the “user” port (the modem or ° d ONLN d¶v HÑ *Pprinter port on your Mac). This means that when you setup your machine to answer ° d ONLN d˜Ñ HíÁ *Lcalls, you can answer only one call at a time on the user port. However, the ° d ONLN dDí H† *Punderlying ARA architecture was designed so that multiple ports may be supported ° d ONLN dï† HÆ ˚ *"(in a dial-in server for example). ° d ONLN d∏º H * MWhen you dial-out on your Mac and establish an ARA connection, ARA internally ° d ONLN d Hÿ *Xallocates the data structures for the user port - but not until a connection is actually ° d ONLN d_ÿ Hʆ *@made. This is why, for example, the Status call will return the
° d ONLN dü€†‰∑ (‚†-5833 ° d ONLN d•È HÚ æ ( HERR_PORTDOESNOTEXIST
° d ONLN dπÊ æÙÊ )v7 error on the originating machine if there is no active ° d ONLN dÒÙ H (˛ HRconnection. Once a connection has been made on a machine that is the originator of ° d ONLN dD H *Wthe connection, the Status call should return no error, because the data structures for ° d ONLN dú H ˆ * the port will have been created. ° d ONLN dΩ, H:¯ * MWhen you make the Status call on a machine that is setup to answer calls (the ° d ONLN d : HH *Tanswer calls box is checked in the Remote Access Setup control panel), you will find ° d ONLN d`H HV … *that you always get the
° d ONLN dxK …TX )Å-5833 ERR_PORTDOESNOTEXIST
° d ONLN díHXV )è# error. The reason for this is that ° d ONLN d∂V Hd‚ (` HHwhen ARA is in answer mode it needs to be able to uniquely identify each ° d ONLN dˇd HrÛ *Mconnection with a separate portGlobalsPtr, because in the future there may be ° d ONLN dMr HÄÎ *Isupport for more than one connection on a single machine. Therefore, on a ° d ONLN dóÄ Hé *Umachine that is setup to answer calls, you must first retrieve the portGlobalsPtr for ° d ONLN dÌé Hú˜ *Othe user port before the Status call can be made. This is accomplished with the ° d ONLN d =ú H™† *?GetUserPortGlobalsPtr call. This call makes use of the familiar ° d ONLN d }™ H∏ *PTRemoteAccessParmHeader structure. The pointer to the port globals for the user ° d ONLN d Œ∏ HΔ *Vport is returned in the portGlobalsPtr field upon completion of the call. Here are the
+H/14 ˇ, d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification
° d ONLN d H H V ˆ ( R H"data structures used by this call: ° d ONLN d # f H t ¶ * The fields in the
° d ONLN d 5 i ¶ r )^TRemoteAccessParmHeader
° d ONLN d L f të )n structure used for the
° d ONLN d d ië rÔ )}GetUserPortGlobalsPtr
° d ONLN d y fÔ t )^ call to ° d ONLN d Ç t H Çb ( ~ H1the Remote Access Manager are defined as follows: ,
Courier
° d ONLN d ¥ í H ù R * -> ° d ONLN d ∑ í l ù v )$12 ° d ONLN d ∫ í ê ù à )$ ioCompletion ° d ONLN d « í ÿ ù Ï )Hlong ° d ONLN d Ã í ¸ ùç )$ pointer to completion routine ° d ONLN d Í ú H ß R ( § H<- ° d ONLN d Ì ú l ß v )$16 ° d ONLN d ú ê ß ∏ )$ioResult ° d ONLN d ˘ ú ÿ ß Ï )Hword ° d ONLN d ˛ ú ¸ ß3 )$ result code ° d ONLN d
¶ H ± R ( Æ H-> ° d ONLN d
¶ l ± v )$20 ° d ONLN d ¶ ê ± ∏ )$userData ° d ONLN d ¶ ÿ ± Ï )Hlong ° d ONLN d ¶ ¸ ±[ )$for use by the user ° d ONLN d2 ∞ H ª R ( ∏ H-> ° d ONLN d5 ∞ l ª v )$26 ° d ONLN d8 ∞ ê ª ∏ )$ioRefNum ° d ONLN dA ∞ ÿ ª Ï )Hword ° d ONLN dF ∞ ¸ ªo )$driver reference number ° d ONLN d^ ∫ H ≈ R ( ¬ H-> ° d ONLN da ∫ l ≈ v )$28 ° d ONLN dd ∫ ê ≈ Æ )$csCode ° d ONLN dl ∫ ÿ ≈ Ï )Hword ° d ONLN dq ∫ ¸ ≈Q )$call command code ° d ONLN dÉ ƒ H œ R ( à H-> ° d ONLN dÜ ƒ l œ v )$40 ° d ONLN dâ ƒ ê œ à )$ extendedType ° d ONLN dñ ƒ ÿ œ Ï )Hlong ° d ONLN dõ ƒ ¸ œà )$ pointer to identifier string ° d ONLN d∏ Œ H Ÿ R ( ÷ H-> ° d ONLN dª Œ l Ÿ v )$42 ° d ONLN dæ Œ ê Ÿ à )$ extendedCode ° d ONLN dÀ Œ ÿ Ÿ Ï )Hword ° d ONLN d– Œ ¸ Ÿ¶ )$"for use by extended call procedure ° d ONLN dÛ ÿ H „ W ( ‡ H<-> ° d ONLN d˜ ÿ l „ v )$44 ° d ONLN d˙ ÿ ê „ Ô )$portGlobalsPtr long ° d ONLN d ÿ ¸ „ˆ )l2pointer to globals for this port (0 = return user ( ‡
port globals)
° d ONLN dV Ú H ˛ ( ¸ HSHere are the detailed descriptions of the parameter block fields used by this call:
° d ONLN d™ H Ñ * ioCompletion ° d ONLN d∑ ê& )H pointer to completion routine. ° d ONLN d÷ H% p (" HioResult ° d ONLN dfl ê%5 )H!result code returned by the call. ° d ONLN d$ H/ p (, HuserData ° d ONLN d
$ ê/& )H user data for use by the user. ° d ONLN d). H9 p (6 HioRefNum ° d ONLN d2. ê9 )Hdriver reference number. ° d ONLN dK8 HC f (@ HcsCode ° d ONLN dR8 lC\ )$0command code, normally set to RAM_EXTENDED_CALL. ° d ONLN dÉB HM Ñ (J H extendedType ° d ONLN dêB êM: )H"should be set to REMOTEACCESSNAME. ° d ONLN d≥L HW Ñ (T H extendedCode ° d ONLN d¿L êWô )H5set to 54 to indicate the GetUserPortGlobalsPtr call. ° d ONLN dˆV Ha é (^ HportGlobalsPtr ° d ONLN dV £a )[Jreturns a pointer to the globals for the port. On input pass 0 to indicate ° d ONLN dT` £k> *
you want the user port globals.
° d ONLN dtz Hà[ (Ñ H2The following result codes can be returned by the
° d ONLN d¶}[Üπ (Ñ[GetUserPortGlobalsPtr
° d ONLN dªzπà“ )^ call:
° d ONLN d¬ò H£ a († HnoErr ° d ONLN d…ò ê£ ï )H0 ° d ONLN dÀò ££ – ) no error. ° d ONLN d’¢ H≠ ¨ (™ HERR_PORTDOESNOTEXIST ° d ONLN dÍ¢ ¥≠ Õ )l-5833 ° d ONLN d¢ ÿ≠< )$port does not exist. ° d ONLN d¨ H∑ ò (¥ HERR_PORTSHUTDOWN ° d ONLN d¨ ¥∑ Õ )l-5832 ° d ONLN d ¨ ÿ∑F )$port is shutting down.
° d ONLN d4Δ H‘} (– H5The following is an example of how you would use the
° d ONLN di…}“€ (–}GetUserPortGlobalsPtr
° d ONLN d~Δ€‘ )^ call prior ° d ONLN dä‘ H‚ ç (fi H to making a
° d ONLN dñ◊ ç‡ ¶ )EStatus
° d ONLN dú‘ ¶‚ ø ) call.
° d ONLN d£Ú H˝ p (˙ H#include ° d ONLN d¨Ú ê˝
)H"RemoteAccessInterface.h" ° d ONLN dΔ H f ( HStr255 ° d ONLN dÕ l û )$
ResultStr; ° d ONLN dÿ H f ( HStr255 ° d ONLN dfl l ô )$ UserName; ° d ONLN dÈ H% f (" HStr255 ° d ONLN d l% ® )$ LastMessage; ° d ONLN d˝$ H/ f (, HStr255 ° d ONLN d$ l/ ® )$ ConnectedTo; ° d ONLN d> HI8 (F H0#define CmdRemoteAccess_GetUserPortGlobalsPtr 54 ° d ONLN dBR H] ì *void DoStatus() ° d ONLN dR\ Hg M *
{ ° d ONLN dUf Hq ª *
TRemoteAccessParamBlock ° d ONLN dmf ÿq Á )êpb; ° d ONLN dsz HÖ. (Ç H. /* Ask LTM driver for PortGlobals address */ ° d ONLN d§é Hô ¸ *$ pb.HDR.csCode = RAM_EXTENDED_CALL; ° d ONLN d éDô£ )¸/* extended call */ ° d ONLN dfiò H£. († H. pb.HDR.extendedType = (Ptr)REMOTEACCESSNAME; ° d ONLN d
òD£ô )¸/* to Netshare */ ° d ONLN d ¢ H≠
(™ HZ pb.HDR.extendedCode = CmdRemoteAccess_GetUserPortGlobalsPtr; /* get user port globals */ ° d ONLN dz¨ H∑ „ *
pb.HDR.portGlobalsPtr = nil; ° d ONLN dú¨D∑Ó )¸"/* 0 = return user port globals */ ° d ONLN dø∂ H¡ „ (æ H PBRemoteAccess( &pb, false ); ° d ONLN dfl¿ HÀ „ *
if (pb.HDR.ioResult != noErr)
+H)15 ˇ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d H H S Ì ( P H! HandleError(pb.HDR.ioResult); ° d ONLN d " R H ] f *
else ° d ONLN d ) \ H g W *
{ ° d ONLN d - p H { „ * /* Issue ARA Status Call */ ° d ONLN d O Ñ H è ± * ResultStr[0] = 0; ° d ONLN d e é H ô) *
- pb.STATUS.resultStrPtr = (Ptr)ResultStr; ° d ONLN d ì éD ô≤ )¸/* put results here */ ° d ONLN d ™ ò H £Q ( † H5 pb.STATUS.extendedCode = CmdRemoteAccess_Status; ° d ONLN d ‡ òh £Ã ( †h/* status command */ ° d ONLN d ı ¢ H ≠ ( ™ H% pb.STATUS.userNamePtr = UserName; ° d ONLN d ¨ H ∑3 *
/ pb.STATUS.connectedToNamePtr = ConnectedTo; ° d ONLN dK ∂ H ¡8 *
0 pb.STATUS.theLastStatusMsgPtr = LastMessage; ° d ONLN d| ¿ H À ¸ *
$ pb.STATUS.statusUserNamePtr = 0; ° d ONLN d° H ’ Ú *
" pb.STATUS.statusMsgSeqNum = 0; ° d ONLN dƒ ‘ H fl Ì *
! PBRemoteAccess( &pb, false ); ° d ONLN dÊ fi H È ¸ *
$ if (pb.STATUS.ioResult != noErr) ° d ONLN d Ë H Û *
& HandleError(pb.STATUS.ioResult); ° d ONLN d2 ¸ H W * } ° d ONLN d6 H M *
}
° d ONLN d8 H, * Thus, to make sure that the RAM
° d ONLN dX!* )æStatus
° d ONLN d^ , )- call will work on machines that are setup to ° d ONLN då, H:> (6 H.answer calls, you will need to first make the
° d ONLN d∫/>8ú )ˆGetUserPortGlobalsPtr
° d ONLN dœ,ú:Ô )^ call so that the ° d ONLN d·: HHÌ (D HHRemote Access Manager knows which port to return status information for.
° d ONLN d*h Hx ã *0MungePW
° d ONLN d2x HÜ *MThe MungePW command is used to encrypt a password to be stored in a document. ° d ONLN dÅÜ Hî *ONormally, when connecting by document, it is not necessary to use this command, ° d ONLN d—î H¢ *Rsince the password in a document is stored in encrypted format. It uses a struct ° d ONLN d$¢ H∞ *ITRemoteAccessPasswordMunger with the inputs username pointer and password ° d ONLN dn∞ Hæ *Rpointer. The reserved field should always be set to zero. The munged password is ° d ONLN d¡æ Hà Œ *return in the data buffer
° d ONLN d⁄ø ŒÀ – )Ü
° d ONLN d€æ –Ãf )pointed to by passWordPtr.
° d ONLN dıøfÀj )ñ
° d ONLN d˜æjà ) It is not necessary to call the ° d ONLN dà H⁄ (÷ HELoad command before using MungePW. The maximum username and password ° d ONLN d]⁄ HË• *?lengths are defined in the RemoteAccessInterface.h header file.
° d ONLN dùÚ H˝ Ú *"struct TRemoteAccessPasswordMunger ° d ONLN d¿¸ H M *
{ ° d ONLN d√ R ≈ +
DRemoteAccessParmHeader ° d ONLN d‹ R Ÿ *
unsigned char *userNamePtr; ° d ONLN d¯ ¸ç )™ // pointer to username string ° d ONLN d R% Ÿ (" Runsigned char *passWordPtr; ° d ONLN d3 ¸%L )™// user password ° d ONLN dE$ R/ (, Runsigned short reserved; ° d ONLN d_$ ¸/[ )™// must set to zero ° d ONLN ds. H9 R (6 H}; ° d ONLN dv8 HC´ *
° d ONLN dæL HZ˜ *LBelow is an example routine that calls and gets the password in *passWordPtr ° d ONLN d Z Hh z *munged. , 2fAppleGaramond Lt 2f ° d ONLN ds HÅ J *
° d ONLN dv JÅ Ù )"#include “RemoteAccessInterface.h” ° d ONLN d7Ä Hã (à H&void MungePassword(UserName, PassWord) ° d ONLN d^ä Hï ˜ *
#unsigned char *UserName, *PassWord; ° d ONLN dÇî Hü M *
$TRemoteAccessPasswordMunger mungePB; ° d ONLN d≠≤ RΩ) *+mungePB.MUNGEPW.csCode = RAM_EXTENDED_CALL; ° d ONLN dŸ≤DΩô )Ú // extended call ° d ONLN dϺ R« (ƒ R#mungePB.MUNGEPW.resultStrPtr = nil; ° d ONLN dºD«ô )Ú // result string ° d ONLN d$Δ R—¶ (Œ RDmungePB.MUNGEPW.extendedType = REMOTEACCESSNAME; // to remote access
+>#16 ˇÇ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d H R Sà ( P R>mungePB.MUNGEPW.extendedCode = CmdRemoteAccess_PassWordMunger; ° d ONLN d @ R R ]t *
:mungePB.MUNGEPW.userNamePtr = (unsigned char *) &UserName; ° d ONLN d | \ R gt *
:mungePB.MUNGEPW.passWordPtr = (unisgned char *) &password; ° d ONLN d ∏ f R q Ú *
PBRemoteAccess(&mungePB, false); ° d ONLN d Ÿ f ¸ qV )™// issue sync call ° d ONLN d Ô p l {H ( x l,// and encrypted the eight bytes in password ° d ONLN d Ñ R è „ ( å R if (mungePB.MUNGEPW.ioResult) ° d ONLN d= é [ ô +
$ShowError(mungePB.MUNGEPW.ioResult); ° d ONLN dd ¢ H ≠ ¢ ( ™ H} // MungePassword
° d ONLN dw ∂ H Δ ´ * GetCodeHooks
° d ONLN dÑ Δ H ‘fl *DThe GetCodeHooks command is used to return a pointer to the remapper ° d ONLN d… ‘ H ‚ *Uprocedure. This routine can then be called to do special remappings for applications ° d ONLN d ‚ H *Wpassing network addresses as part of their data. The call can be made with the clients ° d ONLN dw H ˛ *Lnetwork number and the node number and this routine will return the remapped ° d ONLN dƒ ˛ H å * equivalents.
° d ONLN d— H! Ë * struct TRemoteAccessGetCodeHooks ° d ONLN dÚ H+ M *
{ ° d ONLN dı* R5 ≈ +
DRemoteAccessParmHeader ° d ONLN d4 R? „ *
RemmaperProcPtr remapperProc; ° d ONLN d,4 ¸?ú )™ // quick vector to remapper code ° d ONLN dM> HI R (F H}; ° d ONLN dPH HSó *
° d ONLN dî\ Hjr *8The routine returned by this call is defined as follows:
° d ONLN dÕt H *Xpascal void DoRemapper(unsigned long whereNet, unsigned long incomingFlag, unsigned long ° d ONLN d&~ HâÉ *
?sourceSwapFlag, unsigned short *theNet, unsigned char *theNode) , 2hAppleGaramond Bd 2h ° d ONLN dhí Hú s *
whereNet-> ° d ONLN drí sù )+U This value has the net where this packet just came from or is going to, it is needed ° d ONLN d»ú HßQ (§ H5to determine if any remapping should even take place. 2h ° d ONLN d˛∞ H∫ Ä *incomingFlag-> ° d ONLN d ∞ Ī¨ )8< Set to true if data is incoming, false if data is outgoing. 2h ° d ONLN dIƒ HŒ à (à HsourceSwapFlag-> ° d ONLN dYƒ àœ )@M Set to true if a source style swap is to be used. A source style swap means ° d ONLN dߌ HŸ (÷ HYthat we do remappings based on the address being a source address. If this flag is false, ° d ONLN dÿ H„ Ì *
!destination style swaps are done. 2h ° d ONLN d#Ï Hˆ i *theNet-> ° d ONLN d+Ï i˜ö )!= Pointer to unsigned short containing the net to be remapped. 2h ° d ONLN di H
n ( H theNode-> ° d ONLN dr n ü )&= Pointer to unsigned char containing the node to be remapped. , 2fAppleGaramond Lt 2f
° d ONLN d∞ H J ( H
° d ONLN d± J Ù )"#include “RemoteAccessInterface.h” ° d ONLN d‘ H) é (& HTestRemapper() ° d ONLN d„( H3 M *
{ ° d ONLN dÊ2 R= +
(TRemoteAccessParamBlock getcodehooksPB; ° d ONLN d< RG ∂ *
* NThe following information assumes you have already installed yourself into the ° d ONLN dΔ
H Â *AppleTalk transition queue.
° d ONLN d‚( H8 ˙ * ATTransNetworkTransition
° d ONLN d˚8 HF˚ *GThe ATTransNetworkTransition event will be generated whenever a network ° d ONLN d CF HTˇ *Ptransition occurs. You will be passed the following information using C calling ° d ONLN d îT Hb ë * conventions: ,
Courier
° d ONLN d °l HwŒ *NClientTransitionHandler(long theEvent, Ptr aqe, TNetworkTransition *thetrans); ° d ONLN d Ä Hã p *theEvent ° d ONLN d ˘Ä êã § )H<--- ° d ONLN d ˛Ä ¥ãw )$'will be set to ATTransNetworkTransition ° d ONLN d
&ä Hï W (í Haqe ° d ONLN d
+ä êï § )H<--- ° d ONLN d
0ä ¥ïT )$ points to transition task struct ° d ONLN d
Qî Hü p (ú Hthetrans ° d ONLN d
Zî êü § )H<--- ° d ONLN d
_î ¥üw )$'points to the TNetworkTransition struct
° d ONLN d
â≤ H¿è (º H:The TNetworkTransition struct passed to you is defined as:
+H519 ˇ@ d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d H H S` ( P H8typedef pascal ulong (*NetValidProcPtr)(uPtr,AddrBlock); ° d ONLN d 9 \ H g Ì *!typedef struct TNetworkTransition ° d ONLN d [ f H q M *
{ ° d ONLN d ^ p R { ì +
uPtr private; ° d ONLN d l p ¥ {Y )b!// pointer used internally by 976 ° d ONLN d è z R Ö „ ( Ç R NetValidProcPtr netValidProc; ° d ONLN d ≠ z ¸ Ö∞ )™$// pointer to the network valid proc ° d ONLN d ” Ñ R è ( å RBoolean newConnectivity; ° d ONLN d Ï Ñ ÿ è‹ )Ü4// true=new connectivity, false=loss of connectivity ° d ONLN d! é H ô ± ( ñ H} TNetworkTransition;
° d ONLN d7 ¶ H ¥¸ *OTo check a network number for validity the client uses the netValidProc to call ° d ONLN dá ¥ H ¬I *0Remote Access. This call is defined as follows:
° d ONLN d∏ à H ◊∫ *Jlong netValidProc(TNetworkTransition *thetrans, unsigned long theAddress); ° d ONLN d ‡ H Î p *thetrans ° d ONLN d ‡ ê Î § )H---> ° d ONLN d ‡ ¥ · )$<pass in the TNetworkTransition struct given to you when your ° d ONLN dQ Í ê ı& ( Ú ê transition handler was called. ° d ONLN dp Ù H ˇ ( ¸ H theAddress ° d ONLN d| Ù ê ˇ § )H---> ° d ONLN dÅ Ù ¥ ˇ )$Gthis is the network address you want checked. The format of theAddress ° d ONLN d… ˛ ÿ · +$
5is the same as for the struct AddrBlock as defined in ° d ONLN dˇ ÿ *
AppleTalk.h:
° d ONLN d ê*Ç (& ê'Bytes 3 & 2 (High Word): Network Number ° d ONLN d:* ê8 *Byte 1: Node Number ° d ONLN dQ8 êFL * Byte 0 (Low Byte): Socket Number ° d ONLN drO H] ë (Y H Return codes ° d ONLN dÅ] Rk t +
TRUE ° d ONLN dÜ] êk )>network is still reachable ° d ONLN d¢k Ry x (u RFALSE ° d ONLN d®k êy; )> network is no longer reachable
° d ONLN d«á Hó ñ (ì H Error Codes
° d ONLN d”ß H≤› * Q// ------------------------------------------------------------------------------ ° d ONLN d%± Hº ˜ *
Q// ------------------------------------------------------------------------------ ° d ONLN dõœ H⁄ ¨ *#define MNP_ERR_BASE ° d ONLN d∞œ ¥⁄ Õ )l-6050 ° d ONLN d∑œ ⁄± )l // base for MNP driver errors ° d ONLN d’„ HÓ ˜ (Î H##define ERR_MNP_NEGOTIATION_FAILURE ° d ONLN d˘„Ó^ )Δ(MNP_ERR_BASE-1) ° d ONLN d
„hÓ )Z#// Connection parameter negotiation ° d ONLN d8Ìh¯ö *
// failure ° d ONLN dC˜ H Ë (ˇ H #define ERR_MNP_CONNECT_TIME_OUT ° d ONLN dd˜^ )Δ(MNP_ERR_BASE-2) ° d ONLN du˜h )Z#// Connect request (acceptor mode) ° d ONLN d£h § *
// timed out ° d ONLN d∞ H Ÿ ( H #define ERR_MNP_NOT_CONNECTED ° d ONLN dŒ ^ )Δ(MNP_ERR_BASE-3) ° d ONLN dfl h∏ )Z// Not connected ° d ONLN d H ª ( H#define ERR_MNP_ABORTED ° d ONLN d ^ )Δ(MNP_ERR_BASE-4) ° d ONLN dh )Z // Request aborted by disconnect ° d ONLN dC h*ö *
// request ° d ONLN dN) H4 Ú (1 H"#define ERR_MNP_ATTENTION_DISABLED ° d ONLN dq)4^ )Δ(MNP_ERR_BASE-5) ° d ONLN dÇ)h4 )Z // Link attention service is not ° d ONLN d≠3h>ö *
// enabled ° d ONLN d∏= HH ˜ (E H##define ERR_MNP_CONNECT_RETRY_LIMIT ° d ONLN d‹=H^ )Δ(MNP_ERR_BASE-6) ° d ONLN dÌ=hH )Z#// Connect (initiator mode) request ° d ONLN dGhR€ *
// retry limit reached. ° d ONLN d4Q H\ ˜ (Y H##define ERR_MNP_COMMAND_IN_PROGRESS ° d ONLN dXQ\^ )Δ(MNP_ERR_BASE-7) ° d ONLN diQh\ )Z // Command already in progress. ° d ONLN dâ[ Hf Ì (c H!#define ERR_MNP_ALREADY_CONNECTED ° d ONLN d´[f^ )Δ(MNP_ERR_BASE-8) ° d ONLN dº[hf )Z"// Connection already established. ° d ONLN dfle Hp (m H%#define ERR_MNP_INCOMPATIBLE_PROT_LVL ° d ONLN dep^ )Δ(MNP_ERR_BASE-9) ° d ONLN dehpÔ )Z// Connection failed due to ° d ONLN d;ohz *
// incompatible protocol levels ° d ONLN d[y HÑ Ì (Å H!#define ERR_MNP_HANDSHAKE_FAILURE ° d ONLN d}yÑc )Δ(MNP_ERR_BASE-10) ° d ONLN dèyhÑ )Z // Connection handshake failed. ° d ONLN dØó H¢› (ü HQ// ------------------------------------------------------------------------------ ° d ONLN d ° H¨= *
1// Netshare Error Codes - RemoteAccessInterface.h ° d ONLN d 3´ H∂› *
Q// ------------------------------------------------------------------------------ ° d ONLN d Öø H ò *#define ERR_BASE ° d ONLN d ñø ¥ Õ )l-5800
(Ò ê20 ˇT d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d R H ] ¿ ( Z H#define ERR_NOTCONNECTED ° d ONLN d R ]\ )ÿ (ERR_BASE-0) ° d ONLN d & \ H g Ÿ ( d H #define ERR_CONNECTIONABORTED ° d ONLN d D \ g\ )ÿ (ERR_BASE-1) ° d ONLN d Q f H q ‘ ( n H #define ERR_ALREADYCONNECTED ° d ONLN d n f q\ )ÿ (ERR_BASE-2) ° d ONLN d { p H { ¸ ( x H$#define ERR_COMMANDALREADYINPROGRESS ° d ONLN d † p {\ )ÿ (ERR_BASE-3) ° d ONLN d ≠ z H Ö ∂ ( Ç H#define ERR_BADVERSION ° d ONLN d ƒ z Ö\ )ÿ (ERR_BASE-4) ° d ONLN d — Ñ H è ∂ ( å H#define ERR_INSHUTDOWN ° d ONLN d Ë Ñ è\ )ÿ (ERR_BASE-5) ° d ONLN d ı é H ô fi ( ñ H #define ERR_CONNECTIONABORTING ° d ONLN d é ô\ )ÿ (ERR_BASE-6) ° d ONLN d! ò H £ ( † H#define ERR_ALREADYENABLED ° d ONLN d< ò £\ )ÿ (ERR_BASE-7) ° d ONLN dI ¢ H ≠ ( ™ H#define ERR_ZONEBUFBADSIZE ° d ONLN dd ¢ ≠\ )ÿ (ERR_BASE-8) ° d ONLN dq ¨ H ∑ œ ( ¥ H#define ERR_CONNECTTIMEDOUT ° d ONLN dç ¨ ∑\ )ÿ (ERR_BASE-9) ° d ONLN dö ∂ H ¡ „ ( æ H #define ERR_CONNECTUSERTIMEDOUT ° d ONLN d∫ ∂ ¡a )ÿ
(ERR_BASE-10) ° d ONLN d» ¿ H À ¿ ( » H#define ERR_BADPARAMETER ° d ONLN d· ¿ Àa )ÿ
(ERR_BASE-11) ° d ONLN dÔ H ’ ª ( “ H#define ERR_NOMULTINODE ° d ONLN d ’a )ÿ
(ERR_BASE-12) ° d ONLN d ‘ H fl ( ‹ H#define ERR_ATALKNOTACTIVE ° d ONLN d0 ‘ fla )ÿ
(ERR_BASE-13) ° d ONLN d> fi H È Ÿ ( Ê H #define ERR_NOCALLBACKSUPPORT ° d ONLN d\ fi Èa )ÿ
(ERR_BASE-14) ° d ONLN dj Ë H Û Ÿ ( H #define ERR_NOTOPENEDBYTHISPB ° d ONLN dà Ë Ûa )ÿ
(ERR_BASE-15) ° d ONLN dñ Ú H ˝ ± ( ˙ H#define ERR_NOGLOBALS ° d ONLN d¨ Ú ˝a )ÿ
(ERR_BASE-16) ° d ONLN d∫ ¸ H ≈ ( H#define ERR_NOSMARTBUFFER ° d ONLN d‘ ¸ a )ÿ
(ERR_BASE-17) ° d ONLN d‚ H ¿ ( H#define ERR_BADATALKVERS ° d ONLN d˚ a )ÿ
(ERR_BASE-18) ° d ONLN d H ¿ ( H#define ERR_VLD8_CONNECT ° d ONLN d" % )ÿ0 ° d ONLN d$ H% ≈ (" H#define ERR_VLD8_CALLBACK ° d ONLN d> %a )ÿ
(ERR_BASE-19) ° d ONLN dL$ H/ œ (, H#define ERR_VLD8_BADVERSION ° d ONLN dh$ /a )ÿ
(ERR_BASE-20) ° d ONLN dv. H9 ¿ (6 H#define ERR_VLD8_BADUSER ° d ONLN dè. 9a )ÿ
(ERR_BASE-21) ° d ONLN dù8 HC ‘ (@ H #define ERR_VLD8_BADPASSWORD ° d ONLN d∫8 Ca )ÿ
(ERR_BASE-22) ° d ONLN d»B HM ¿ (J H#define ERR_VLD8_BADLINK ° d ONLN d·B Ma )ÿ
(ERR_BASE-23) ° d ONLN dÔL HW Ú (T H"#define ERR_VLD8_NOCALLBACKALLOWED ° d ONLN dL Wa )ÿ
(ERR_BASE-24) ° d ONLN d V Ha Ì (^ H!#define ERR_VLD8_ALLCBSERVERSBUSY ° d ONLN dBV aa )ÿ
(ERR_BASE-25) ° d ONLN dP` Hk Ë (h H #define ERR_VLD8_GUESTNOTALLOWED ° d ONLN dq` ka )ÿ
(ERR_BASE-26) ° d ONLN dj Hu Ì (r H!#define ERR_VLD8_SERVERISIMPOSTER ° d ONLN d°j ua )ÿ
(ERR_BASE-27) ° d ONLN dØt H Ë (| H #define ERR_VLD8_LOGINNOTENABLED ° d ONLN d–t a )ÿ
(ERR_BASE-28) ° d ONLN dfi~ Hâ ˜ (Ü H##define ERR_REMOTEPORTALREADYEXISTS ° d ONLN d~ âa )ÿ
(ERR_BASE-29) ° d ONLN dà Hì (ê H#define ERR_OPENNOTALLOWED ° d ONLN d+à ìa )ÿ
(ERR_BASE-30) ° d ONLN d9í Hù ‘ (ö H #define ERR_NOUSERSANDGROUPS ° d ONLN dVí ùa )ÿ
(ERR_BASE-31) ° d ONLN ddú Hß ¿ (§ H#define ERR_PORTSHUTDOWN ° d ONLN d}ú ßa )ÿ
(ERR_BASE-32) ° d ONLN d㶠H± ‘ (Æ H #define ERR_PORTDOESNOTEXIST ° d ONLN d®¶ ±a )ÿ
(ERR_BASE-33) ° d ONLN d∂∞ Hª Ÿ (∏ H #define ERR_PWNEEDEDFORENABLE ° d ONLN d‘∞ ªa )ÿ
(ERR_BASE-34) ° d ONLN d‚∫ H≈ ß (¬ H#define ERR_DAMAGED ° d ONLN dˆ∫ ¥≈ ı )l
(ERR_BASE-35) ° d ONLN dƒ Hœ ‘ (à H #define ERR_NETCONFIGCHANGED ° d ONLN d!ƒ œa )ÿ
(ERR_BASE-36) ° d ONLN d/Œ HŸ ≈ (÷ H/* 2.0 and above only… */ ° d ONLN dIÿ H„ k *
#define ° d ONLN dQÿ t„ ‚ ),ERR_NOSUPPORT_ATREMOTE ° d ONLN dhÿ „a )¨
(ERR_BASE-37) ° d ONLN dv‚ HÌ „ (Í H #define ERR_CONFLICTING_REQUEST ° d ONLN dñ‚ Ìa )ÿ
(ERR_BASE-38) ° d ONLN d§Ï H˜ k (Ù H#define ° d ONLN d¨Ï t˜ ˆ ),ERR_VLD8_INVALIDAUTHMETHOD ° d ONLN d«Ï ˜a )¨
(ERR_BASE-39) ° d ONLN d’ˆ H k (˛ H#define ° d ONLN d›ˆ t … ),ERR_VLD8_CONTINUE ° d ONLN dÔˆ a )¨
(ERR_BASE-40) ° d ONLN d˝ H k ( H#define ° d ONLN d t Œ ),ERR_PWCHANGECANCEL ° d ONLN d a )¨
(ERR_BASE-41) ° d ONLN d&
H ( H'#define ERR_VLD8_MANUALPASSWORDREQUIRED ° d ONLN dN
a )ÿ
(ERR_BASE-50) ° d ONLN d\ H) ì (& H#define ERR_END ° d ONLN dl ¥)O )l ERR_VLD8_MANUALPASSWORDREQUIRED ° d ONLN då h)‡ )¥/* must be last error */ ° d ONLN d•F HQ› (N HQ// ------------------------------------------------------------------------------ ° d ONLN d˜P H[B *
2// Connection Control Language Error Codes - CCL.h ° d ONLN d*Z He› *
Q// ------------------------------------------------------------------------------ ° d ONLN d|n Hy k *#define ° d ONLN dÑn ty ø ),cclErr_BaseCode ° d ONLN dîn Óy )z-6000 ° d ONLN döx HÉ k (Ä H#define ° d ONLN d¢x tÉ › ),cclErr_AbortMatchRead ° d ONLN d∏x ÓÉ> )z cclErr_BaseCode ° d ONLN d xhÉ )z // internal error used to abort ° d ONLN dÙÇhç§ *
//match read ° d ONLN d å Hó k (î H#define ° d ONLN d å tó í ),cclErr ° d ONLN d å ÓóW )z(cclErr_BaseCode - 6) ° d ONLN d 'åhóΩ )z// CCL error base ° d ONLN d 9ñ H° ≈ (û H#define cclErr_CloseError ° d ONLN d Sñ Ó°W )¶(cclErr_BaseCode - 7) ° d ONLN d iñh° )z$// There is at least one script open ° d ONLN d é† H´ fi (® H #define cclErr_ScriptCancelled ° d ONLN d ≠† Ó´W )¶(cclErr_BaseCode - 8) ° d ONLN d √†h´¬ )z// Script Canceled ° d ONLN d ◊™ Hµ k (≤ H#define ° d ONLN d fl™ tµ ” ),cclErr_TooManyLines ° d ONLN d Û™ ÓµW )z(cclErr_BaseCode - 9) ° d ONLN d
™hµÔ )z// Script contains too many ° d ONLN d
/¥høê *
// lines ° d ONLN d
8æ H… œ (Δ H#define cclErr_ScriptTooBig ° d ONLN d
Tæ Ó…\ )¶(cclErr_BaseCode - 10) ° d ONLN d
kæh…Ô )z// Script contains too many
(Ò ê21 ˇ . d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
// characters ° d ONLN d R H ] k ( Z H#define ° d ONLN d R t ] › ),cclErr_NotInitialized ° d ONLN d , R Ó ]\ )z(cclErr_BaseCode - 11) ° d ONLN d C Rh ]« )z// CCL has not been ° d ONLN d a \h gÆ *
// initialized ° d ONLN d p f H q k ( n H#define ° d ONLN d x f t q Á ),cclErr_CancelInProgress ° d ONLN d ê f Ó q\ )z(cclErr_BaseCode - 12) ° d ONLN d ß fh q÷ )z// Cancel in progress. ° d ONLN d æ p H { k ( x H#define ° d ONLN d Δ p t { › ),cclErr_PlayInProgress ° d ONLN d ‹ p Ó {\ )z(cclErr_BaseCode - 13) ° d ONLN d Û ph {Í )z// Play command already in ° d ONLN d zh Ö§ *
// progress. ° d ONLN d% Ñ H è k ( å H#define ° d ONLN d- Ñ t è µ ),
cclErr_ExitOK ° d ONLN d; Ñ Ó è\ )z(cclErr_BaseCode - 14) ° d ONLN dR Ñh è÷ )z// Exit with no error. ° d ONLN di é H ô k ( ñ H#define ° d ONLN dq é t ô ø ),cclErr_BadLabel ° d ONLN dÅ é Ó ô\ )z(cclErr_BaseCode - 15) ° d ONLN dò éh ô÷ )z// Label out of range. ° d ONLN dØ ò H £ ≈ ( † H#define cclErr_BadCommand ° d ONLN d… ò Ó £\ )¶(cclErr_BaseCode - 16) ° d ONLN d‡ òh £≥ )z// Bad command. ° d ONLN d ¢ H ≠ k ( ™ H#define ° d ONLN d¯ ¢ t ≠ › ),cclErr_EndOfScriptErr ° d ONLN d ¢ Ó ≠\ )z(cclErr_BaseCode - 17) ° d ONLN d% ¢h ≠ )z// End of script reached, ° d ONLN dI ¨h ∑¬ *
// expecting Exit. ° d ONLN d\ ∂ H ¡ k ( æ H#define ° d ONLN dd ∂ t ¡ ‚ ),cclErr_MatchStrIndxErr ° d ONLN d{ ∂ Ó ¡\ )z(cclErr_BaseCode - 18) ° d ONLN dí ∂h ¡Ù )z // Match string index is out ° d ONLN d∏ ¿D ÀÖ ( »D
// of bounds. ° d ONLN dΔ H ’ k ( “ H#define ° d ONLN dŒ t ’ ø ),cclErr_ModemErr ° d ONLN dfi Ó ’\ )z(cclErr_BaseCode - 19) ° d ONLN dı h ’ )z// Modem error, modem not ° d ONLN d ‘å fl“ +$
// No @HANGUP ° d ONLN d˘8 HC› (@ HQ// ------------------------------------------------------------------------------ ° d ONLN dKB HM= *
1// Link Tool Manager Error Codes - LTMInterface.h ° d ONLN d}L HW› *
Q// ------------------------------------------------------------------------------ ° d ONLN dœ` Hk k *#define ° d ONLN d◊` tk ∞ ), ERR_LTM_BASE ° d ONLN d‰` ¸k )à-5900 ° d ONLN dÎ`Vk” )Z// base of errors for LTM ° d ONLN dj Hu Ú (r H"#define ERR_LTM_LISTENER_ID_IN_USE ° d ONLN d(j ¸uL )¥(ERR_LTM_BASE-1) ° d ONLN d9jVu
)Z$// Specified Listener identifier is ° d ONLN dhtVÉ *
// in use ° d ONLN dr~ Hâ œ (Ü H#define ERR_LTM_NO_LISTENER ° d ONLN dé~ ¸âL )¥(ERR_LTM_BASE-2) ° d ONLN dü~Vâ
)Z$// Listener of specified type is not ° d ONLN dŒàVìí *
// available ° d ONLN d€í Hù` (ö H8#define ERR_LTM_RESOURCE_NOT_REGISTERED (ERR_LTM_BASE-3) ° d ONLN díhù (öh$// Listener of specified type is not ° d ONLN dDúhߧ *
// available ° d ONLN dQ¶ H± Ë (Æ H #define ERR_LTM_PORT_NOT_CLAIMED ° d ONLN dr¶ ¸±L )¥(ERR_LTM_BASE-4) ° d ONLN dɶV± )Z"// claim request failed because to ° d ONLN d∞∞Vª° *
// port is busy ° d ONLN d¿∫ H≈ ˜ (¬ H##define ERR_LTM_COMMAND_NOT_ALLOWED ° d ONLN d‰∫ ¸≈L )¥(ERR_LTM_BASE-5) ° d ONLN dı∫V≈Á )Z // LTM command not allowed on ° d ONLN d ƒVœ´ *
// specified port ° d ONLN d/Œ HŸ œ (÷ H#define ERR_LTM_BAD_VERSION ° d ONLN dKŒ ¸ŸL )¥(ERR_LTM_BASE-6) ° d ONLN d\ŒVŸŒ )Z// connect failed due to ° d ONLN dÿV„‚ *
// incompatible LTM versions ° d ONLN dú‚ HÌ ˜ (Í H##define ERR_LTM_ARBITRATION_TIMEOUT ° d ONLN d¿‚ ¸ÌL )¥(ERR_LTM_BASE-7) ° d ONLN d—‚VÌ )Z"// Connection failed due to a time ° d ONLN d˛ÏV˜ÿ *
// out during the listener ° d ONLN d #ˆVú *
// arbitration ° d ONLN d 2 H fi ( H #define ERR_LTM_KODE_NOT_FOUND ° d ONLN d Q ¸ L )¥(ERR_LTM_BASE-8) ° d ONLN d b V Á )Z // kode resource not found in ° d ONLN d ä
V´ *
// specified file ° d ONLN d ú H Ÿ ( H #define ERR_LTM_PORT_DISPOSED ° d ONLN d ∫ ¸ L )¥(ERR_LTM_BASE-9) ° d ONLN d ÀV ˚ )Z!// A Dispose Port call caused the ° d ONLN d ˜ V)µ *
// request to fail. ° d ONLN d
( H3 Ë (0 H #define ERR_LTM_RESOURCE_CLAIMED ° d ONLN d
,( ¸3Q )¥(ERR_LTM_BASE-10) ° d ONLN d
>(V3 )Z"// call failed because resource is ° d ONLN d
k2V=∞ *
// already claimed ° d ONLN d
~< HG (D H&#define ERR_LTM_PORT_RESOURCES_CLAIMED ° d ONLN d
•< Gu )ÿ(ERR_LTM_BASE-11) ° d ONLN d
∑<åG )l// call failed because the ° d ONLN d
fiFåQˇ *
// port’s resources are ° d ONLN d På[Ê *
// already claimed ° d ONLN d Z He ¸ (b H$#define ERR_LTM_RESOURCE_NOT_CLAIMED ° d ONLN d :Z
e_ )¬(ERR_LTM_BASE-12) ° d ONLN d LZhe )^#// call failed because the resource ° d ONLN d {dho∏ *
// was unclaimed ° d ONLN d ån Hyt (v H<#define ERR_LTM_PORT_RESOURCES_NOT_CLAIMED (ERR_LTM_BASE-13) ° d ONLN d …nåy (vå// The LTM port's resources ° d ONLN d xåÉÎ *
// are NOT claimed. ° d ONLN d Ç Hç fi (ä H #define ERR_LTM_PORT_UNCLAIMED ° d ONLN d #Ç ¸çQ )¥(ERR_LTM_BASE-14) ° d ONLN d 5ÇVç‚ )Z // LTM listen port unclaimed ° d ONLN d Rå Hó Ú (î H"#define ERR_LTM_CONNECTION_REFUSED ° d ONLN d uå ¸óQ )¥(ERR_LTM_BASE-15) ° d ONLN d áåVóÒ )Z // LTM listener refused connect ° d ONLN d ∞ñV°à *
// request ° d ONLN d ª† H´ Ÿ (® H #define ERR_LTM_CLAIM_ABORTED ° d ONLN d Ÿ† ¸´Q )¥(ERR_LTM_BASE-16) ° d ONLN d ΆV´ˆ )Z // LTM claim call aborted due to ° d ONLN d
™Vµ‚ *
// LTM_ARB_CLAIM_CANCEL call ° d ONLN d
3¥ Hø Ë (º H #define ERR_LTM_END_OF_PORT_LIST ° d ONLN d
T¥ ¸øQ )¥(ERR_LTM_BASE-17) ° d ONLN d
f¥Vø )Z#// End of open port list reached in ° d ONLN d
îæV…Ï *
// current port status session
(Ò ê22 ˇò d ˇ ˇˇˇˇ d
d , Palatino
. +H-Apple Remote Access API )ê External Reference Specification ,
Courier
° d ONLN d R H ] Ÿ ( Z H #define ERR_LTM_NOT_CONNECTED ° d ONLN d R ¸ ]Q )¥(ERR_LTM_BASE-18) ° d ONLN d 0 RV ]´ )Z// Not connected. ° d ONLN d B \ H g Ú ( d H"#define ERR_LTM_CONNECTION_ABORTED ° d ONLN d e \ ¸ gQ )¥(ERR_LTM_BASE-19) ° d ONLN d w \V gÁ )Z // Connection request aborted ° d ONLN d ï f H q ( n H#define ERR_LTM_BAD_LENGTH ° d ONLN d ∞ f ¸ qQ )¥(ERR_LTM_BASE-20) ° d ONLN d ¬ fV q )Z"// Length of write request exceeds ° d ONLN d Ô pV {ç *
